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Foreword 


The C language under CP/M-68K™ is easy to read, easy to maintain, and highly 
portable. CP/M-68K can run most applications written in C for the UNIX® operating 
system, except programs that use the UNIX fork/exec multitasking primitives or that 
read UNIX file structures. 

The C Language Programming Guide for CP/M-68K is not a tutorial. This manual 
describes how to program in C under the CP/M-68K operating system, and is best used 
by programmers familiar with the C language as described in The C Programming 
Language (Kernighan and Ritchie, 1978). 

The commonly accepted standard for C language programming is the Portable C 
Compiler (PCC), written by Stephen C. Johnson. Many versions of the UNIX operating 
system use PCC, including the Zilog®, ONYX™, Xenix®, Berkeley UNIX, and UN1Q 
systems. 

The CP/M-68K C compiler differs from PCC on the following points: 

■ The CP/M-68K C int (default) data type is 16 bits long. Pointers are 32 bits long. 
All function definitions and function calls that use long (32-bit ints) and pointer 
parameters must use the proper declarations. 

■ long, int, and char register variables are assigned to D registers. Five such registers 
are available in each procedure. 

■ Any register variable used as a pointer is assigned to an A register. There are 
three such registers available in each procedure. 

■ All local declarations in a function body must precede the first executable 
statement of the function. 

■ The CP/M-68K C compiler handles structure initialization as if the structure 
were an array of short integers, as in UNIX version 6. 

■ The first eight characters of variable and function names must be unique. The 
first seven characters of external names must be unique. 

■ The CP/M-68K C compiler does not support floating point. 

■ The CP/M-68K C compiler does not support structure assignment, structure 
arguments, and structures returned from procedures. 

■ The CP/M-68K C compiler does not support initialization of automatic variables. 

■ The CP/M-68K C compiler does not support enumeration types. 


lu 


Section 1 of this manual describes the conventions of using C language under 
CP/M-68K. Section 2 discusses C language compatibility with UNIX version 7 and 
provides a dictionary of C library routines for CP/M-68K. Section 3 presents a style 
guide for coding C language programs. 

Appendix A is a table of CP/M-68K error codes. Appendix B discusses compiler 
components, tells you how to operate the compiler, and suggests ways to conserve the 
disk space used for compiling. Appendix C presents sample C modules that are written 
and documented according to the style conventions outlined in Section 3. 
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Section 1 

Using C Language Under CP/M-68K 



1.1 Compiling a CP/M-68K C Program 

To create an executable C program under CP/M-68K, uae the C.SUB 
and CLINK. SUB command files. The C.SUB file invokes the C compiler 
and the CLINK. SUB file invokes the linker. Use the following 
command line format to invoke the C compiler. Note that the command 
keyword SUBMIT is optional and that the source file must have a C 
file type. You must not specify the C file type in the compiler 
command line. 


A>CSUBM1T] C filename 

The compiler produces an object file with a 0 filetype. The 
linker uses the object file to create the executable program. Use 
the following command line format to invoke the linker. Again, the 
command keyword SUBMIT is optional. You must not specify the 0 
filetype in the linker command line for the object file. 


A> [SUBMIT] CLINK filename 

You can specify multiple object files for linking into an 
executable program. For example, the first three command lines 
below compile source files named ONE.C, TWO.C, and THREE. C. The 
last command line links the three object files that the compiler 
creates into an executable program named ONE.68K 


A> submit c one 

A> submit c two 

A> submit c three 

A> submit clink one two three 


To link C programs that use floating point math, substitute the 
CLINKF file for CLINK in the preceding example. CLINKF uses the 
Motorola FFP floating point format which is considered the fastest. 
To compile and link programs that use IEEE floating point format, 
substitute the CE file for C and the CLINKE file for CLINK in the 
preceding examples. 
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1.2 Memory Layout 

The memory allocation of C programs running under CP/M-68K is 
similar to that of UNIX C programs. A program consists of three 
segments: the text segment or program instruction area, the data 
segment for initialized data, and the BSS or block storage segment 
for uninitialized data. There are two dynamic memory areas: the 
stack and the heap. Procedure calls and automatic variables use the 
stack. Data structures such as symbol tables use the heap. The 
brk, sbrk, malloc, and free C functions manage the heap. Figure i-l 
shows how each of the areas are arranged in memory. 


TPA HIGH 


BREAK 
END 
EDATA 
ETEXT 
TPA LOW 

Figure 1-1. Memory Layout 


STACK (GROWS TO LOWER ADDRESSES) 


HEAP (GROWS TO HIGHER ADDRESSES) 
BLOCK STORAGE SEGMENT 
DATA SEGMENT 
TEXT SEGMENT 


The linker determines the locations etext, edata, and end. These 
locations are the ending addresses of the text, data, and BSS 
segments. The break location is the first unused address following 
the heap. 


1.3 Calling Conventions 

The JSR instruction (jump to subroutine) calls a C language 
procedure. Register A6 acts as the frame pointer to reference local 
storage. Arguments are pushed onto the A7 stack in reverse order. 
Word and character arguments occupy 16 bits. Long, floating point, 
and pointer arguments occupy 32 bits. All function values return in 
register DO. Functions that specify no return value actually return 
an undefined value. 
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1.3 Calling Conventions 


For example, the following sequence 




xyx() { 


long 

a; 

int 

b; 

char 

x? 

register 

y; 


b ■ blivot(x,a); 
generates the following codes: 


xyz: 


link 

a6 , #-8 

novel . 1 

d6-d7 , - ( 27 ) 

mov e . 1 

-4(a6), (a7 ) 

mov e . b 

-8(a6),d0 

ext . w 

dO 

move . w 

dO, -<a7) 

jsr 

bli vot 

add . 1 

#2,a7 

mov e . w 

dO , 6 ( a6 ) 

tst.l 

(a7 ) + 

movem. 1 

(a7)+,d7 

unlk 

a6 

rts 



* Space for a,b,x 
*d7 used for y 
*d6 reserves space 

* Load parameter a 

* Load parameter x 

* Extend to word size 

* Push it 

* Call subroutine 

* Pop argument list 

* Store return parameter 

* Purge longword 

* Unsave registers 

* Restore frame pointer 

* Return to caller 
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C code, in which all arguments are the same length, might not 
work without modif ication because of the varying length of arguments 
on the stack. •* 3 3 3 

The compiler adds an underline character, , to the beginning of 
each external variable or function name. This means that all 
external names in C must be unique in seven characters. 

The compiler-generated code maintains a long word at the top of 
the stack for use in subroutine calls. This shortens the stack- 
popping code required on return from a procedure call. The movem.l 
instruction, which saves the registers, contains an extra register 
to allocate this space. 

The compiler uses registers D3 through D7, and A3 through A5, for 
register variables. A procedure called from a C program must save 
and restore these registers, if they are used. The compiler- 
generated code saves* only those registers used. Registers DO 
through D2, and AO through A2 , are scratch registers and can be 
modified by the called procedure. 


1.4 Stack Frame 

Figure 1-2 illustrates the standard C stack frame. 


LONGWORD FOR PROCEDURE CALLS 

SAVED REGISTERS 

LOCAL VARIABLE AREA ' 

A6— w- PREVIOUS VALUE OF A6 

RETURN ADDRESS 
ARGUMENT 1 
ARGUMENT 2 


Figure 1-2. C Stack Frame 
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1.4 Stack Frame 


Arguments are either two or four bytes depending on the argument 
type. The compiler generated code uses register A6 to reference all 
variables on the stack. 


1.5 Command Line Interface 

The standard C argc/argv interface for arguments typed on the 
command line also works under CP/M-68K. For example, the command 

command argl arg2 arg3 . . . argn 

produces the following interface setup: 


argc 

arg[0] 

argil] 

arg[2] 


n+1 

"C Runtime" 
' "argl" 
"arg2" 


argv[n] 


argn 


You cannot obtain the command name under CP/M-68K. Therefore, the 
argv£0] argument always contains the string “C Runtime . 

Strings that contain the characters * or ? are interpreted as 
wildcarded filenames. The C runtime start-up routine scans the 
directory and expands each wildcarded filename into a list of 
filenames that match the specification. To pass a string that 
contains * or ? characters to a C program, enclose the string in 
single or double quotation marks. Similarly, enclose argument 
strings that contain embedded blanks in quotation marks to pass them 
to a C program as a single element of argv[]. 


1.6 I/O Conventions 

UNIX C programs use two types of file and device I/O: regular 
and stream files. A unique number called the file descriptor 
identifies regular files. In CP/M-68K, file numbers range from 0 to 
15. The address of a user control block in the run-time system 
identifies stream files. Unlike regular files, stream files use a 
form of intermediate buffering that makes single-byte I/O more 
ef f icient. 

Under UNIX, you can reference peripheral devices, such as 
terminals and printers, as files using the special names /dev/tty 
for terminal and /dev/lp for printer. Under CP/M-68K, CON: is for 
the console device and LST: is for the listing device. 
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CP/M-6BK stores ASCII files with a carriage return line feed 
after each line. A CTRL-Z (Oxla) character indicates end— of-file. 
C programs usually end lines with only a line feed. This means that 
in C for CP/M-6BK, read and write operations to ASCII files must 
insert and delete carriage-return characters. The CTRL-Z must be 
deleted on read and inserted on close for such files. These 
operations are not desirable for binary files. CP/M-68K C includes 
an extra entry point to all file open and creat calls to distinguish 
between ASCII and binary files. 


1.7 Standard Piles 

C programs begin execution with three files already open: the 
standard input, standard output, and standard error files. You can 
access these files as either stream or regular files in a C program. 
The usual C library routines close and reopen the standard files. 
The following definitions are in the <stdio.h> file. 


Table 1-1. Standard Pile Definitions 


File 


File 


Descriptor 


Stream Same 


standard input 
standard output 
standard error 


STDIN 

STDOUT 

STDERR 


stdin 

stdout 

stderr 
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1.8 1/0 Redirection 


1.8 I/O Redirection 

You can redirect C program standard I/O using the < and > 
characters. For example* the following command executes the file 
TEST.68K. The standard input comes from file DAT and the standard 
output goes to the listing device. The argument list is C, D, E, 
and F. 

A>TEST <DAT >LST: C D E F 

You cannot place spaces between the < or > characters and the 
filename that the character refers to. Note that you cannot 
redirect the standard error file. 

You can append information to an existing file using the 
following specification: 

>>filename s 

The standard output from the program specified by the filename 
appears after the original contents of the file. 


End of Section 1 
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Section 2 

C Language Library Routines 


The CP/M-68K C library is a collection of routines for I/O, 
dynamic memory allocation, system traps, and data conversion. 


2.1 Compatibility with UNIX V7 

The C library is compatible with UNIX version 7, allowing 
programs to move easily from UNIX to CP/M-68K. CP/M-68K C simulates 
many UNIX operating system calls and features. However, CP/M-68K 
does not support the following C functions that UNIX implements: 


• the fork/exec, kill, lock, nice, pause, ptrace, sync, and wait 
primitives 

• the acct system call 

• the alarm function, or the stime, time, ftime, and times system 
calls 

• the dup and dup2 duplicate file descriptor functions 

• the getuid, getgid, geteuid, getegid, setuid, and setgid 
functions 

• the indir indirect system call 

• the ioctl, stty, and gtty system calls 

• the link system call 

• the chdir, chroot, mknod, mount, umount, mpx, pipe, pkon, 
pkoff, profil, sync, stat, fstat, umask, and utime system calls 

• the phys system call 
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The following UNIX library functions are not available under CP/M- 
68K: 


• Assert 

• Crypt 

• DBM 

• Getenv 

• Getgrent, getlogin, getpw, and getpwent functions 

• 13tol , 1 tol3 

• monitor 

• itom, madd, msub, mult, mdiv, min, mout, pow, gcd, and rpow 

• nlist 

• pkopen, pkclose, pkread, pkwrite, and pkfail 

• plot 

• popen, pclose 

• sleep 

• system 

• ttyslot 


The CP/M-68K C language library does not contain the floating- 
point routines available under UNIX. 

Entry points have been added to file open and creat calls to 
distinguish between ASCII and binary files. Byte level end-of-file 
is unavailable for binary files. ASCII files, however, are 
compatible with UNIX, and with the CP/M-68K text editors and 
utilities that use ASCII files. 

The C Programming Gu id e for CP/M-68K does not separate the UNIX 
system calls and library functions; all calls are library functions 
under CP/M-68K. 


2.2 Library Functions under CP/M-68K 

The remainder of this section alphabetically lists library 
routines that C supports under CP/M-68K. The C compiler accepts 
entry in upper- and lower-case; however, type all library routines 
lower-case , as shown in the calling sequences. 
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abort Function 


abort Function 


The abort function terminates the current program with an error. 
The error is system dependent. The '’000 uses an illegal 
instruction trap. This invokes DDT-6BK'*, ii he debugger is loaded 
with the object program. 


Calling Sequence: 
WORD code; 
abort (code ) ; 


Arguments ; ' 

code loads into register DO before abort 


Returns: 


The abort function never returns. 
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aba Function 


The abs function takes the absolute value of a single argument. 
This function is implemented as a macro in <stdio.h>; arguments with 
side effects do not work as you expect. For example, the call 

a ■ abs(*x++) ; 

increments x twice. 


Calling Sequence: 

WORD val; 

WORD ret; 

ret • abs ( val ) ; 

Arguments ; 

val the input value 

Returns ; 

ret the absolute value of val 
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access function 


access Function 


The access function checks whether the calling program can access 
a specified file. Under CP/M-68K, the file is accessible if it 
exists. 


Calling Sequence: 

BYTE *name; 

WORD mode ; 

WORD ret; 

ret * access (name, mode) ; 


Arguments; 


name 


points to the null-terminated filename 


mode can be one of four values: 

4 checks read access 

2 checks write access 

1 checks execute access 

0 checks directory path access 

CP/M-68K ignores the 0 argument 


Returns: 

ret 0 if file access is allowed or -1 if not allowed 


Note: 

CP/M-68K only checks to see if the specified file exists. 
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. -net ions 


atoi, atof, atoi Functions 


The atoi, atof, and atoi functions convert an ASCII digit string 
to an integer, float, or long binary number, respectively. The atoi 
and atoi functions convert digit strings of the form C~3£+]dddddd. . . 
The atof function converts digit strings of the form £- 
Jl+ jddddd . ddd£ e[ - ]dd ] . Each "d" is a decimal digit. The compiler 
ignores all leading spaces, but permits a leading sign. Conversion 
proceeds until the number of digits in the string is exhausted. 
Each function returns a 0 when there are no more digits to convert. 


Calling Sequence: 

BYT E * s t r i ng ; 

WORD ival.atoif); 
LONG 1 val , a „ol ( ) ; 
FLOAT f val , a tof ( ) ; 

ival = atoi ( string ) ; 
lval = atoi ( s tr ing ) ; 
fval = a tof { string ) ; 


Arguments : 

a pointer to a null-terminated string that contains 
the number to convert 


Returns : 

i y al atoi returns the converted string as an integer 

lval atoi returns the converted string as a long binary 

number 


fval 


atof returns the converted string as a single- 
precision floating-point number 


Note : 

The atoi, atoi, and atof functions do not detect or report 
overflow. Therefore, you cannot specify a limit to the number 
of contiguous digits processed or determine the number of 
digits a function processes. 
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brk, sbrk Functions 


brk, sbrk Functions 


The brk and sbrk functions extend the heap portion of the user 
program. The brk function sets the upper bound of the program, 
called the break in UNIX terminology, to an absolute address. The 
sbrk function extends the program by an incremental amount. 


Calling Sequence; 

WORD brk(); 

BYTE *addr, *sbrk( ) ; 
WORD ret; 

BYTE *start; 

ret =» brk (addr) ; 
start * sbrk (incr) ; 


Arguments : 

addr the desired new break address 

incr the incremental number of bytes desired 

Returns ; 

0 success (brk) 

-1 failure (brk) 

start begins the allocated area (sbrk) 

0 failure (sbrk) 
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calloc, malloc , realloc, free Functions 


The calloc, malloc, realloc, and free functions manage the 
dynamic area between the region and the stack. 

The malloc function allocates an area of contiguous bytes aligned 
on a word boundary and returns the address of this area. Malloc 

uses the sbrk function to allocate additional heap space, if 
necessary. c v 

The calloc function allocates space for an array of elements, 
whose size is given in bytes. 

realloc function changes the size of a block. The address of 
the block returns. 

% 

The free function releases a block previously allocated bv 
mall ac * * 


Calling Sequence: 

WORD size, number; 

BYTE *addr , *malloc { ) , *calloc( ) , *realloc ( ) ; 

addr = malloc(size) ; 
addr = calloc (number, size) ; 
addr = realloc ( addr , s ize ) ; 
free(addr) ; 


Arguments : 

size the number of bytes desired 
number the number of elements desired 
addr points to the allocated region 

Returns : 


Address of the allocated region if successful, 0 if 
unsuccess ful . 


Note: 


Freeing a bogus address can be disastrous. 
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ceil Function 


ceil Function 


The ceil function returns the smallest integer that is greater 
than the argument you specify. For example, ceil(1.5) returns 2.0. 
The return value is a floating-point number. 


Calling Sequence? 

FLOAT ceil(); 

FLOAT arg; 

FLOAT ret; 

ret = ceil(arg) ; 

% 

Arguments: 

arg a floating-point number 
Returns : 

ret a floating-point number 
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chmod, chown Functions 


Under UNIX, the chmod and chown system calls allow you to change 
the protection and owner ID of an existing file. CP/M-68K treats 
these calls as NO-OPS if the file exists. 


Calling Sequence: 

BYTE ‘name; 

WORD mode, owner, group, ret; 

ret = chmod ( name , mode ) ; 

ret = chown (name, owner , group) ; 


Arguments : 

name the affected filename (null-terminated) 
mode the new mode for the file 

owner the new owner of the file 

group the new group number 


Returns: 

ret 0 if the file exists 

-1 if the file does not exist 
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close Function 


close Function 


The close function terminates access to a file or device. This 
routine acts on files opened with the open or creat functions. 
Specify a file descriptor, not a stream, for the operation. The 
fclose function closes stream files. 


Calling Sequence: 

WORD fd,ret; 
ret * close (fd ) t 

Arguments: » 

fd the file descriptor to be closed 

Returns: 

0 successful close 

-1 unknown file descriptor 
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cos, sin Functions 


The cos function returns the trigonometric cosine of a floating- 
point number. The sin function returns the trigonometric sine of a 
floating-point number. You must express all arguments in radians. 


Calling Sequence: 

FLOAT cos(),sin(); 
FLOAT val, ret; 

ret » cos (val) ; 
ret - sin (val) ; 


Arguments : 

val a floating-point number that expresses an angle in 
radians 


Returns : 


the cosine or sine of the argument value expressed in 
radians 


Note : 

The best results occur with arguments that are less than 2 pi. 
You can pass numbers declared as either float or double to cos 
and sm. 
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creat, create, creatb Functions 


creat, create, creatb Functions 


The creat function adds a new file to a disk directory. The file 
can then be referenced by the file descriptor, but not as a stream 
file. The creat and creata functions create an ASCII file. The 
creatb function creates a binary file. 


Calling Sequence; 

BYTE *name; 

WORD mode, fd; 

fd = creat (name, mode) ; 
fd = create^ name, mode) ; 
fd = creatb (name, mode) ; 


Ar guments ; 

name the filename string, null-terminated 
mode the UNIX file mode, ignored by CP/M-68K 

Returns : 

fd The file descriptor for the opened file. A file 

descriptor is an int quantity that denotes an open 
file in a read, write, or lseek call. 

-1 Returned if there are any errors. 

Note: 


UNIX programs that use binary files compile successfully, but 
execute improperly. 
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ctype Functions 


The file <ctype.h> defines a number of functions that classify 
ASCII characters. These functions indicate whether a character 
belongs to a certain character class, returning nonzero for true and 
zero for false. The following table defines ctype functions. 


Table 

2-1 

ctype Functions 

Function 

- 

Meaning 

isalpha(c) 

c 

is 

a letter. 

is upper ( c ) 

c 

is 

upper-case . 

i slower ( c ) 

c 

is 

lower-case . 

isdigit( c ) 

c 

is 

a digit. 

isalnum( c ) 

c 

is 

alphanumeric. 

is space ( c ) 

c 

is 

a white space character. 

ispunct(c) 

c 

is 

a punctuation character. 

ispr int( c ) 

c 

is 

a printable character. 

iscntrl(c) 

c 

is 

a control character. 

isascii (c ) 

c 

is 

an ASCII character (< 0x80). 


The white space characters are the space (0x20), tab (0x09), 
carriage return (OxOd), line-feed (0x0a), and form-feed (0x0c) 
characters. Punctuation characters are not control or alphanumeric 
characters. The printing characters are the space (0x20) through 
the tilde (0x7e). A control character is less than a space (0x20). 
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Calling Sequence: 

♦include <ctype.h> 

WORD ret; 

BYTE c; /* or WORD c; */ 

ret = isalpha(c); 
ret * is upper (c); 
ret » islower(c); 
ret * isdigit(c); 
ret * isalnum(c); 
ret = isspace(c); 
ret = ispunct(c); 
ret = isprintic); 
ret * iscntrl(c); 
ret * isascii(c); 


Arguments; 

c the character to be classified 


Returns ; 

ret = 0 for false 

ret <>0 for true 


Note : 

These functions are implemented as macros; arguments with side 
effects, such as *p++, work incorrectly in some cases. Bogus 
values return if arguments are not ASCII characters. For 
example, >0x7f. 
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end, etext, edata Locations 


The linkage editor defines the 
the first location past the 
respectively. The program-break 
location, is initially set to end. 
alter this location. sbrk(O) can 


labels end, etext, and edata as 
BSS, text, and data regions, 
location, which is the last used 
However, many library functions 
retrieve the break. 
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etoa, ftoa Functions 


The etoa and ftoa functions convert a floating-point number to an 
ASCII string. Both functions return the address of the converted 
string buffer. The string returned in the buffer takes the form 
E-]d. ddddde[-]dd. Each "d“ is a decimal digit. 


Calling Sequence? 

FLOAT fval ; 

BYTE *ftoa( ),*etoa(),*buf,*retr 
WORD prec; 

ret = etoa ( fval, buf , prec) ; 
ret = f toa ('f val, buf, prec) ; 


Arguments : 

fval “ the floating point number to be converted 

buf the address of the buffer for the digit string 

prec the number of digits to appear to the right of the 

decimal point in the converted string 

Returns : 

ret the address of the buffer for the converted, null- 
terminated string 
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exit, exit Functions 


The exit function passes control to CP/M-68K. An optional 
completion code, which CP/M-68K ignores, might return. exit 
deallocates all memory and closes any open files, exit also flushes 
the buffer for stream output files. 

The _exit function immediately returns control to CP/M-68K, 
without flushing or closing open files. 


Calling Sequence: 

WORD code; 

exit ( code ) ; 
exit(code) ; 


Ar quments ; 

code optional return code 


Returns : 


no returns 
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exp Function 


The exp function returns the constant e raised to a specified 
exponent. The constant e is the base of natural logarithims equal 
to 2.71828182845905. 


Calling Sequence: 

FLOAT exp(); 

FLOAT f val , r e t ; 

ret = exp(fval),* 

Arguments : s 

fval the exponent expressed as a floating-point number 

Returns: 

ret the value of e raised to the specified exponent 

Note : 

You can pass numbers declared as either float or double to exp. 
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fabs Punction 


The fabs function returns the absolute value of a floating-point 
number. 


Calling Sequencer 

FLOAT fabs ( ) ; 

FLOAT fval ; 

FLOAT retval; 

retval = fabs (fval); 


Arguments ; * 

fval a floating point number 

Returns : 

retval the absolute value of the floating-point number 
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fclose, fflush Functions 


The fclose and fflush functions close and flush stream files. 
The stream address identifies the stream to be closed. 


Calling Sequence t 

WORD ret; 

FILE ^stream; 

ret « fclose(stream) ; 
ret =* fflush( stream) ; 


Arguments s % 

stream the stream address 

Returns: 

0 successful 

-1 bad stream address or write failure 
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feof, terror, clearerr, fileno Functions 


These functions manipulate file streams in a system-independent 
manner. 

The feof function returns nonzero if a specified stream is at 
end-of-file, and zero if it is not. 

The ferror function returns nonzero when an error has occurred on 
a specified stream. The clearerr function clears this error. This 
is useful for functions such as putw, where no error indication 
returns for output failures. 

The fileno function returns the file descriptor associated with 
an open stream. 


Calling Sequenc e: 

WORD ret; 

FILE "stream; 

WORD fd; 

ret = feof ( stream) ; 
ret = ferror (stream) ; 
clearerr.( stream) ; 
fd » £ ileno(stream) ; 


Ar guments ; 

stream the stream address 
Returns : 

ret a zero or nonzero indicator 

fd the returned file descriptor 
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floor Function 


The floor function returns the largest integer 
the argument you specify. The returned value is 
number. For example, floor (1.5) returns 1.0. 


Calling Sequence; 

FLOAT floor(); 

FLOAT fval; 

FLOAT retval; 

retval = floor (fval); 


Arguments : 

fval a floating-point number 


Returns ; 


retval a floating-point integer value 


that is less than 
a floating-point 
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fmod 


Function 


The fmod function returns the floating-point modulus (remainder) 
from a division of two arguments. fmod divides the first argument 
by the second and returns the remainder. 


Calling Sequence; 

FLOAT fmod ( ) ; 
FLOAT x , y ; 

FLOAT re t ; 

ret * fmod( x, y) ; 


Arguments : 

x a floating-point dividend 

y a floating-point divisor 

Returns: 

ret the modulus as a floating-point number 

I 
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fopen, freopen, fdopen Functions 


The fopen, freopen, and fdopen functions associate an I/O stream 
with a file or device. 

The fopen and fopena functions open an existing ASCII file for 
I/O as a stream. The fopenb function opens an existing binary file 
for I/O as a stream. 

The freopen and freopa functions substitute a new ASCII file for 
am open stream. The freopb function substitutes a new binary file 
for an open stream. 

The fdopen function associates a file that file descriptor 
opened, using open or creat, with a stream. 


Calling Sequence; 

FILE *f open( ) , f open a ( ) , f openb( ) ; 
FILE *freopen( ), freopa { ), freopb( ) ,• 
FILE *fdopen(); 

FILE ^stream; 

BYTE *name, ^access: 

WORD fd; 


stream 

stream 

stream 

stream 

stream 

stream 

stream 


fopen (name, access) ; 
fopena (name, access) ; 
fopenb( name, access ) ; 
freopen ( name , access , stream ) ; 
freopa (name, access , stream) ; 
freopb (name, access, stream) ; 
fdopen ( fd, access) ; 


fopen, i reopen, 

tdcpen Functions Z Language Programming Guide 

Arguments: 


■" •• ^ 

name 

the 

null -terminated filename string 

stream 

the 

stream address 

access 

the 

access string: 


r 

read the file 


w 

write the file 


a 

append to a file 



Returns ; 

stream successful if stream address open 
0 unsuccessful 




Note : 


UNIX programs that use 
correctly, but execute 


fopen on binary files compile and link 
improperly. 
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fread, fwrite Functions 


The fread and fwrite functions transfer a stream of bytes between 
a stream file and primary memory. 


Calling Sequence : 

WORD ni terns; 

BYTE *buff; 

WORD size; 

FILE ^stream; 

nitems - fread(buf f, size, nitems, stream) ; 
nitems = fwrite(buff, size, nitems, stream) ; 


Arguments ; 

buff the primary memory buffer address 
size the number of bytes in each item 

nitems the number of items to transfer 
stream an open stream file 


Returns : 

nitems the number of items read or written 
0 error, including EOF 
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fseek, ftell, rewind Functions 


The fseek, ftell, and rewind functions position a stream file. 

The fseek function sets the read or write pointer to an arbitrary 
offset in the stream. The rewind function sets the read or write 
pointer to the beginning of the stream. These calls have no effect 
on the console device or the listing device. 

The ftell function returns the present value of the read or write 
pointer in the stream. This call returns a meaningless value for 
nonfile devices. 


Calling Sequence; 

WORD ret; 

FILE ‘stream; 

LONG of fset, ftell () ; 

WORD ptrname; 

ret = fseek( stream, of fset, ptrname ) ; 
ret » rewind (stream) ; 
offset * ftell ( stream) ; 


Arguments ; 

stream the stream address 

offset a signed offset measured in bytes 

ptrname the interpretation of offset; 

0 «> from beginning of file 

1 => from current position 

2 => from end of file 


Returns : 

ret 0 for success, -1 for failure 

offset present offset in stream 


Note : 


ASCII file seek and tell operations do not account for carriage 
returns that are eventually deleted. CTRL-Z characters at the 
end of the file are correctly handled. 
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getc. getehar, fgetc, getw, getl Functions 


The getc, getehar, fgetc, getw, and getl functions perform input 
from a stream. 

The getc function reads a single character from an input stream. 
This function is implemented as a macro in <stdio.h>, and arguments 
should not have side effects. 

The getehar function reads a single character from the standard 
input. It is identical to getc(stdin) in all respects. 

The fgetc function is a function implementation of getc, used to 
reduce object code size. 

The getw function reads a 16-bit word from the stream, high byte 
first. This is compatible with the read function call. No special 
alignment is required. 

The getl function reads a 32-bit long from the stream, in 68000 
byte order. No special alignment is required. 


Calling Sequencer 

WORD ichar; 

FILE ‘stream; 

WORD iword; 

LONG ilong, getl( ) ; 


ichar 

ichar 

ichar 

iword 

ilong 


gete(5tream) ; 
getehar { ) ; 
fgetc ( stream) ; 
getw( stream) ; 
getl (stream) ; 



getc , 


getw, geci 


' T-anguage Programming Guide 


Ar guments ; 

stream the stream address 


Returns : 

ichar character read from stream 

iword word read from stream 

ilong longword read from stream 
-1 on read failures 


Note : 

Error return from getchar is incompatible with UNIX prior to 
version 7. Error return from getl or getw is a valid value 
that might occur'in the file normally. Use feof or terror to 
detect end-of-rile or read errors. 
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getpass Function 


The getpass function reads a password from the console device. A 
prompt is output, and the input read without echoing to the console. 
A pointer returns to a 0- to 8-character null-terminated string. 


Calling Sequence: 

BYTE * prompt? 

BYTE *getpass; 

BYTE *pass; 

pass = ge tpass( prompt ) ; 


Arguments : 

prompt a null-terminated prompt string 


Returns: 


pass points to the password read 


Note ; 

The return value points to static data whose content is 
overwritten by each call. 
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getpid Function 


The getpid function is a bogus routine that returns a false 
process ID. This routine is strictly for UNIX compatibility; serves 
no purpose under CP/M-68K. The return value is unpredictable in 
some implementations. 


Calling Sequence; 

WORD pid; 
pid * getpid ( ) ; 

Arguments ; 

no arguments. 

Returns : 

pid false process ID 


2-32 


C Language Programming Guide 


gets, f gets Functions 


gets, fgets Functions 


The get. ud fgets function. ! 

Iget. reads a string ” “ ly fro . the standard input, 

aets deletes the newline, ana reaas owy u r w.r»pter 

loth function, ter.in.te the string,, with . null character. 


You must specify a maximum count wit.*. 
This count includes the terminating null 


fgets, but not with gets, 
character . 


Calling Sequence; 

BYTE ‘addr; 

BYTE ^ j * 

BYTE # gets{ K*fgets( ) ; 
WORD n; 

FILE ‘stream; 

addr * gets(s) ; 

addr » fgets(s,n, stream) ; 


Arguments: 

a the string buffer area address 

n the maximum character count 

stream the input stream 


Returns: 

addr the string buffer address 
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Index, 



rindex Functions 


The index and rindex functions locate a given character 
string. index returns a pointer to the first occurrence of 
character, rindex returns a pointer to the last occurrence. 


in a 
the 


Calling Sequence; 

BYTE c; 

BYTE *s ; 

BYTE *ptr; 

BYTE *index( ) , *rindex( ) ; 

ptr = index (s,c) ; 
ptr = rindex(s,ci ; 


Arguments ; 

s a null-terminated string pointer 

c the character for which to look 


Returns : 



ptr 

0 


the desired character address 
character not in the string 
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isatty Function 


A CP/M-68K program can use the isatty function to determine 
whether a file descriptor is attached to the CP/M-68K console device 
(CON: ) . 


Calling Sequence: 

WORD fd; 

WORD ret; 

ret * isatty( fd) ; 


Arguments: 

fd an open file descriptor 


Returns: 

1 fd attached to CON: 

0 fd not attached to CON: 


log Function 
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log Function 


The log function returns the natural logarithm (log base e) of a 
floating-point number. 


Calling Sequence; 

FLOAT log(); 
FLOAT fval, ret; 

ret * log ( fval ) ; 


Arguments ; 

% 

fval a floating-point number 
Returns : 

ret the natural logarithim of the floating-point number 


Note : 


You can pass numbers declared as either float or double to log. 
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lseek, tell Functions 


The lseek function positions a file referenced toy the file 
descriptor to an arbitrary offset. Do not use this function with 
stream files, because the data in the stream buffer might be 
invalid. Use the fseek function instead. 

The tell function determines the file offset of an open file 
descriptor. 


Calling Sequence? 

WORD fd; 

WORD ptrname; 

LONG offset', lseek( ) ,tell( ) ,ret; 

ret * lseek ( fd, of f set, ptrname ) ; 
ret = tell < fd) ; 


Arguments : 

fd the open file descriptor 

offset a signed byte offset in the file 
ptrname the interpretation of offset: 

0 => from this beginning of the file 

1 *> from the current file position 

2 => from the end of the file 


Returns : 


ret resulting absolute file offset 

-1 error 


Note: 


Incompatible with versions 1 through 6 of UNIX. 
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mktemp Function 


The mktemp function creates a temporary filename. The calling 
argument is a character string ending in 6 X characters. The 
temporary filename overwrites these characters. 


Calling Sequence: 

BYTE ‘string; 

BYTE *mktemp(); 

string = ink temp (string); 


Arguments ; 

string the address of the template string 


Returns : 


string the original address argument 
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open# opena# openb Functions 


The open and opena functions open an existing ASCII file by file 
descriptor. The openb function opens an existing binary file. The 
file can be opened for reading, writing, or updating. 


Calling Sequence: 

BYTE *name; 

WORD mode; 

WORD fd; 

f d = open ( name , mode ) ; 
fd « opena ( name , mode ) ; 
fd * openb ( dame, mode ) ; 


Arguments : 

name the null-terminated filename string 

mode the access desired: 

0 => Read-Only 

1 -> Write-Only 

2 => Read-Write (update) 


Returns : 

fd the file descriptor for accessing the file 

-1 open failure 


Note : 

UNIX programs that use binary files compile correctly, but 
execute improperly. 
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perror Function 


The perror function writes a short message on the standard error 
file that describes the last system error encountered. First an 
argument string prints, then a colon, then the message. 

CP/M-68K C simulates the UNIX notion of an external variable, 
errno, that contains the last error returned from the operating 
•y#tem. Appendix A contains a list of the possible values of errno 
and of the messages that perror prints. 


Calling Sequence : 

BYTE *s; 

WORD err; 

err = perror ( s ) ; 


Arguments : 

s the prefix string to be printed 


Returns : 


err value of "ERRNO" before call 


Note : 


Many messages are undefined on CP/M-68K. 
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pow Function 


The pow function returns the value of a number raised to a 
specified power; pow uses two floating-point arguments. The first 
argument is the mantissa and the second argument is the exponent. 


Calling Sequence: 

FLOAT pow ( ) ; 
FLOAT x,y; 
FLOAT ret; 

ret = pow(x,_ ) ; 


Arguments : 

x a floating-point mantissa 

y a floating-point exponent 

Returns : 

ret the value of the mantissa raised to the exponent 
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printf, fprintf, sprintf Functions 


The printf functions format data for output. The printf function 
outputs to the standard output stream. The fprintf function outputs 
to an arbitrary stream file. The sprintf function outputs to a 
string (memory). 


Calling Sequence: 

WORD ret; 

BYTE *fmt: 

FILE ^stream; 

BYTE ^string; 

BYTE *sprintf ( ),rs; 

/* Args can be any type *( 


ret 

* printf ( fmt,argl ,arg2 ...),- 

ret 

= fprintf ( stream, fmt , argl ,arg2 ...); 

rs 

= sprintf (s tring, fmt , argl , arg2 ...); 

Arguments : 

fmt 

format string with conversion specifiers 

argn 

data arguments to be converted 

stream 

output stream file 

string 

buffer address 

Returns : 

• 

ret 

number of characters output 
-1 if error 

rs 

buffer string address 
null if error 


Conversion Operators 

A percent sign, %, in the format string indicates the start of a 
conversion operator. Values to be converted come in order from the 
argument list. Table 2-2 defines the valid conversion operators. 
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Table 2-2. Conversion Operators 


Opera tor 

Meaning 

d 

Converts a binary number to decimal ASCII 
and inserts in output stream. 

Q 

Converts a binary number to octal ASCII and 
inserts in output stream. 

X 

Converts a binary number to hexadecimal 
ASCII and inserts in output stream. 

c 

Uses the argument as a single ASCII 
character . 

s 

Uses the argument as a pointer to a null- 
' terminated ASCII string, and inserts the 
string into the output stream. 

u 

Converts an unsigned binary number to 
decimal ASCII and inserts in output stream. 

« 

Prints a % character. 


You can insert the following optional directions between the % 
character and the conversion operator: 


• A minus sign justifies the converted output to the left, 
instead of the default right justification. 

• A digit string specifies a field width. This value gives the 
minimum width of the field. If the digit string begins with a 
0 character, zero padding results instead of blank padding. An 
asterisk takes the value of the width field as the next 
argument in the argument list. 

• A period separates the field width from the precision string. 

• A digit string specifies the precision for floating-point 
conversion, which is the number of digits following the decimal 
point. An asterisk takes the value of the precision field from 
the next argument in the argument list. 

• The character 1 or L specifies that a 32-bit long value be 
converted. A capitalized conversion code does the same thing. 
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putc, putchar, fputc, putw, putl Functions 


The putc, putchar, fputc, putw, and putl functions output 
characters and words to stream files. 

The putc function outputs a single 8-bit character to a stream 
file. This function is implemented as a macro in <stdio.h>, so do 
not use arguments with side effects. The fputc function provides 
the equivalent function as a real function. 

The putchar function outputs a character to the standard output 
■ tream file. This function is also implemented as a macro in 
<stdio.h> . Avoid using side effects with putchar. 

The putw function outputs a 16-bit word to the specified stream 
file. The word is output high byte first, compatible with the write 
function call. 

The putl function outputs a 32-bit longword to the stream file. 
The bytes are output in 68000 order, as with the write function 
call . 


Calling Sequence: 

BYTE c; 

FILE ^stream; 

WORD w, ret ; 

LONG lret , putl ( ) , 1 ; 

ret = putc'(c, stream) ; 
ret = fputc(c, stream) ; 
ret = putchar (c); 
ret = putw{w, stream) ; 
lret = putl ( 1, stream) ; 
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fputc, putw, putl 


Arguments: 

c the character to be output 

stream the output stream address 

w the word to be output 

1 the long to be output 


Returns : 


ret 

the 

word 

or character 

output 

lret 

the 

long 

output with 

putl 

-1 

an 

output 

error 



Note : 

% 

A -1 return from putw or putl is a valid integer or long value. 
Use ferror to detect write errors. 
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puts, fputs Functions 


The puts and fputs functions output a null-terminated string to 
an output stream. 

The puts function outputs the string to the standard output, and 
appends a newline character. 

The fputs function outputs the string to a named output stream. 
The fputs function does not append a newline character. 

Neither routine copies the trailing null to the output stream. 


Calling Sequence: 

WORD ret; 

BYTE *s; 

FILE ‘stream; 

ret = puts { s ) ; 

ret = fputs ( s, stream) ; 


Arguments : 

s the string to be output 

stream the output stream 


Returns : 

ret the last character output 

-1 error 


Note : 


The newline incompatibility is required for compatibility with 
UNIX. 
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qsort Function 


The qsort function is a quick sort routine. You supply a vector 
of elements and a function to compare two elements, and the vector 
returns sorted. 


Calling Sequence: 

WORD ret; 

BYTE *base ; 

WORD number ; 

WORD size; 

WORD compare(); 

% 

ret * qsort (base , number, size, compare) ; 


Arguments : 

base the base address of the element vector 
number the number of elements to sort 
size size of each element in bytes 
compare the address of the comparison function 

This function is called by the following: 

ret = compare (a, b) ; 

The return is: 

<0 if a < b 

=0 if a = b 

>0 if a > b 


Returns, ; 

0 always 
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rand, srand Functions 


The rand and srand functions constitute the C language random 
number generator. Call srand with the seed to initialise the 
generator . Call rand to retrieve random numbers. The random 
numbers are C int quantities. 


Calling Sequence: 

WORD seed; 

WORD mum; 

mum * srand (seed); 
rnum * rand(); 

Ar guments ; 

seed an int random number seed 
Returns ; 

rnum desired random number 
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read Function 


The read function reads data from a file opened by the file 
descriptor using open or creat. You can read any number of bytes, 
starting at the current file pointer. 

Under CP/M-68K, the most efficient reads begin and end on 128- 
byte boundaries. 


Calling Sequence; 

WORD ret; 

WORD fd; 

BYTE ‘buffer; 

WORD bytes; ' 

ret = read( fd, buffer, bytes); 


Arguments : 

fd a file descriptor open for read 

buffer the buffer address 

bytes the number of bytes to be read 

Returns ; 

ret number of bytes actually read 

-1 error 
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scant, fscanf, sscanf Functions 


The scant functions convert input format. The scant function 
reads from the standard input, fscanf reads from an open stream 
file, and sscanf reads from a null-terminated string. 


Calling Sequence; 

BYTE *f or mat, ^string; 

WORD nitems; 

FILE ‘stream; 

/* Args can be any type */ 

nitems = scant ( forma t ,argl ,arg2 . ..); 
nitems ■ fscanf (“stream, format, argl ,arg2 . ..); 
nitems = sscanf (string, format, argl ,arg2 . ..); 


Arguments: 

format the control string 

argn pointers to converted data locations 
stream an open input stream file 
string null- ter minated input string 

Returns : 

nitems the number of items converted 
-1 I/O error 

Control String Fo r mat 

The control string consists of the following items: 


• Blanks, tabs, or newlines (line feeds) that match optional 
white space in the input. 

• An ASCII character (not %) that matches the next character of 
the input stream. 

• Conversion specifications, consisting of a leading %, an 
optional * (which suppresses assignment), and a conversion 
character. The next input field is converted and assigned to 
the next argument, up to the next inappropriate character in 
the input or until the field width is exhausted. 
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Conversion characters indicate the interpretation of the next input 
field. The following table defines valid conversion characters. 


Table 2-3. Valid Conversion Character* 


Character 

Meaning 

% 

A single % matches in the input at this 
point; no conversion is performed. 

d 

Converts a decimal ASCII integer and stores 
it where the next argument points. 

o 

Converts an octal ASCII integer. 

X 

% Converts a hexadecimal ASCII integer. 

s 

A character string, ending with a space, is 
input. The argument pointer is assumed to 
point to a character array big enough to 
contain the string and a trailing null 
character, which are added. 

c 

Stores a single ASCII character, including 
spaces. To find the next nonblank 

character, use %ls. 

c 

Stores a string that does not end with 
spaces-. The character string is enclosed in 
brackets. If the first character after the 
left bracket is not * , the input is read 
until the scan comes to the first character 
not within the brackets. If the ^first 
character after the left bracket is , the 
input is read until the first character 
within the brackets. 
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The setjmp and longjmp functions execute a nonlocal GOTO. The 
setjmp function initially specifies a return location. You can then 
call longjmp from the procedure that invoiced setjmp, or any 
subsequent procedure, longjmp simulates a return from setjmp in the 
procedure that originally invoked setjmp. A setjmp return value 
passes from the longjmp call. The procedure invoking setjmp must 
not return before longjmp is called. 


Calling Sequence: 

♦include <setjmp.h> 
WORD xret, re tr 
jmp buf envr * 


xret = setjmp(env); 


long jmp ( env .ret); 


Ar guments : 

env contains the saved environment 

ret the desired return value from setjmp 

Returns ; 

xret 0 when setjmp invoked initially 

copied from ret when longjmp called 

Note : 


awkward 
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signal Function 


The signal function connects a C function with a 68000 •*c*pt io n 
condition. Each possible exception condition is indicated y 
number. The following table defines exception 


conditions. 


Table 2-4. 68000 Exception Conditions 


Number 

| Condition 

4 

Illegal instruction trap. Includes illegal 

instructions, privilege violation, and line 
and line F traps. 

5 

Trace trap. 

6 

Trap instruction other than 2 or 3; used by 
BOOS and BIOS. 

8 

Arithmetic traps: zero divide, CHK 

instruction, and TRAPV instruction. 

10 

BUSERR (nonexistent memory) or addressing 
(boundary) error trap. 


All other values are ignored for compatibility with UNIX. 

Returning from the procedure activated by 
normal processing. The library routines preserve registers and 

condition codes. 
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sinh, tanh Function 


The sinh function returns the trigonometric hyperbolic sine of a 
floating-point number. The tanh function returns the trigonometric 
hyperbolic tangent of a floating-point number. You must express all 
arguments in radians. 


Calling Sequence; 

FLOAT sinh( ) < tanh( ) ; 
FLOAT fval,ret? 

ret = sinh(fval); 
ret = tanh(£ al); 


Arguments : 

fval a floating-point number that expresses an angle in 
radians 

Returns : 

ret the hyperbolic sine or hyperbolic tangent of the 
argument value expressed in radians 

Note : 

You can pass numbers declared as either float or double to sinh 
and tanh. 
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sqrt Function 


The sqrt function returns the square root of a 
number. 


floating-point 


Calling Sequence: 

FLOAT sqrt(); 
FLOAT fval, ret; 

ret = sqr t( fval ) ; 


Arguments ; 

* 

fval a floating-point number 


Returns : 


ret 


the square root of the specified argument 


Note 


You can pass numbers declared as either float or double to 
sqrt . 
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street, strncat Functions 


The street and strncat functions concatenate strings. The street 
function concatenates two null-terminated strings. The strncat 
function copies a specified number of characters. 


Calling Sequence: 

BYTE *sl,*s2,*ret; 

BYTE *strcat< ) , *strncat( ) ; 

WORD n; 

ret = strcatfsl ,s2) ; 

ret = str neat ( si , s2, n) ; 

% 

At guments: 

si the first string 

s2 the second string, appended to si 

n the maximum number of characters in si 


Returns: 

ret a pointer to si 


Note : 

The street (si, si) function never terminates and usually 
destroys the operating system because the end-of-string marker 
is lost, so streat continues until it runs out of memory, 
including the memory occupied by the operating system. 
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•tremp, strnemp Functions 


The stremp and strnemp functions compare strings. The stremp 
function uses null termination, and strnemp limits the comparison to 
a specified number of characters. 


Calling Sequence; 

BYTE *sl,*s2; 

WORD val,n; 

val * strcmp(sl,s2) ; 
val * strnemp ( si , s2 , n) ,* 


Arguments : 

si a null-terminated string address 

s2 a null-terminated string address 

n the maximum number of characters to compare 

Returns: 


val the comparison result: 

< 0 => si < s2 
= 0 => si = s2 
> 0 => si > s2 


Note : 

Different machines and compilers interpret the characters as 
signed or unsigned. 
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strcpy, strncpy Functions 


The strcpy and strncpy functions copy one null -terminated string 
to another. The strcpy function uses null-termination, while 
strncpy imposes a maximum count on the copied string. 


Calling Sequence: 

BYTE *sl,*s2,*ret; 

BYTE *s trcpy ( ) , * s trncpy ( ) ; 
WORD n; 

ret « strcpy (si, s2); 
ret * strr py(sl,s2,n); 


Arguments: 

si the destination string 

s2 the source string 

n the maximum character count 


Returns: 

ret the address of si 


Note: 

If the count is exceeded in strncpy, the destination string is 
not null-terminated. 
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strlen Function 


The strlen function 
string. 


returns the length of 


a 


null- ter nina ted 


Calling Sequence: 

BYTE *s ; 

WORD len; 

len * strlen{ s ) ; 


Ar guments : 
s 


the string 


address 


Returns : 


len 


the string length 
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swab Function 


The swab function copies one area of memory to another. The high 
and low bytes in the destination copy are reversed. You can use 
this function to copy binary data from a PDP-ir* or VAX" to the 
68000. The number of bytes to swap must be even. 


Calling Sequence: 

WORD ret; 

BYTE * from,* to? 

WORD nbytes; 

ret = swab , from, to, nbytes ) ; 


Arguments : 

from the address of the source buffer 

to the address of the destination 

nbytes the number of bytes to copy 

Returns : 

ret always 0 
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tan, atan Functions 


The tan function returns the trigonometric tangent of a floating- 
point number. The atan function returns the trigonometric 
arctangent of a floating-point number. You must express arguments 
to tan in radians. 


Calling Sequence; 

FLOAT tan ( ) , a tan ( ) ; 

FLOAT val, rval, ret; 

ret = tan (rval); 
ret = atan( val ) ; 

% 

Argum e nts ; 

rval a floating-point number that expresses an angle in radians 
val a floating-point number 

Returns : 

ret the tangent or arctangent of the argument value 
expressed in radians 


Note : 


The best precision results with arguments that are less than 
two pi. You can pass numbers declared as either float or 
double to tan and atan. 
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ttyname Function 


The ttyname function returns a pointer to the null-terminated 
filename of the terminal device associated with an open file 
descriptor. * 


Calling Sequence; 

BYTE ‘name ,* ttyname ( ) ; 
WORD fd; 

name = ttyname ( fd) ; 


Arguments: 

fd an open file descriptor 

Returns: 


A pointer to the null-terminated string CON: if the file 

descriptor is open and attached to the CP/M-68K console device. 
Otherwise, zero (NULL) returns. 
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ungetc Function 


The ungetc function pushes a character back to an input stream. 
The next getc, getw, or getchar operation incorporates the 
character. One character of buffering is guaranteed if something 
has been read from the stream. The fseek function erases any 
pushed-back characters. You cannot ungetc EOF (-1). 


Calling Sequence; 

BYTE c; 

FILE * stream; 

WORD ret; 

ret = ungetc (c,srtream); 


Arguments : 

c the character to push back 

stream the stream address 

R eturns ; 

ret. c if the character is successfully pushed back 

-1 error 
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unlink Function 


The unlink function deletes a named file from the file system. 
The removal operation fails if the file is open or nonexistent. 


Calling Sequence ; 

WORD ret; 

BYTE *name; 

ret = unlink (name) ; 


Arguments : 


name the null-terminated filename 


Returns: 

0 success 

-1 failure 
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write Function 


The write function transfers data to a file opened by file 
descriptor. Transfer begins at the present file pointer, as set by 
previous transfers or by the lseek function. You can write any 
arbitrary number of bytes to the file. The number of bytes actually 
written returns. If the number of bytes written does not match the 
number requested, an error occurred. 

Under CP/M-68K, the most efficient writes begin and end on 128- 
byte boundaries. 


Calling Sequ e nce: 

WORD fd; 

BYTE ‘buffer; 

WORD bytes; 

WORD ret; 

ret = write ( fd, buff er , bytes) ; 


Arguments : 

fd the open file descriptor 

buffer the starting buffer address 
bytes the number of bytes to write 


Returns ; 

ret the number of bytes actually written 

-1 errors 


Note ; 

Due to the buffering scheme used, all data is not written to 
the file until the file is closed. 


End of Section 2 
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To make your C language programs portable, readable, and easy to maintain, follow 
the stylistic rules presented in this section. However, no rule can predict every situation; 
use your own judgment in applying these principles to unique cases. 

3.1 Modularity 

Modular programs' reduce porting and maintenance costs. Modularize your pro- 
grams, so that all routines that perform a specified function are grouped in a single 
module. This practice has two benefits: first, the maintenance programmer can treat 
most modules as black boxes for modification purposes; and second, the nature of data 
structures is hidden from the rest of the program. In a modular program, you can change 
any major data structure by changing only one module. 

3.1.1 Module Size 

A good maximum size for modules is 500 lines. Do not make modules bigger than 
the size required for a given function. 

3.1.2 Intermodule Communication 

Whenever possible, modules should communicate through procedure calls. Avoid 
global data areas. Where one or more compilations require the same data structure, use 
a header file. 
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3.1.3 Header Files 

In separately combined files, use header files to define types, symbolic constants, and 
data structures the same way for all modules. The following list gives rules for using 
header files. 

■ Use the l #include “file.h”’ format for header files that are project-specific. Use 
‘#include <file.h>’ for system-wide files. Never use device or directory names 
in an include statement. 

■ Do not nest include files. 

■ Do not define variables other than global data references in a header file. Never 
initialize a global variable in a header file. 

■ When writing macro definitions, put parentheses around each use of the parame- 
ters to avoid precedence mix-ups. 


3.2 Mandatory Coding Conventions 

To make your programs portable, you must adhere strictly to the conventions 
presented in this section. Otherwise, the following problems can occur: 

■ The length of a C int variable varies from machine to machine. This can cause 
problems with representation and with binary I/O that involves int quantities. 

■ The byte order of multibyte binary variables differs from machine to machine. 
This can cause problems if a piece of code views a binary variable as a byte stream. 

■ Naming conventions and the maximum length of identifiers differ from machine 
to machine. Some compilers do not distinguish between upper- and lower-case 
characters. 

■ Some compilers sign-extend character and short variables to int during arithmetic 
operations; some compilers do not. 

■ Some compilers view a hex or octal constant as an unsigned int; some do not. 
For example, the following sequence does not always work as expected: 

LONG data; 

« 

« 

< 

printf ( "Ild\n H » ( data & Oxffff))! 
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The printf statement prints the lower 1 6 bits of the long data item data. However, 
some compilers sign-extend the hex constant Oxffff. 

■ You must be careful of evaluation-order dependencies, particularly in compound 
BOOLEAN conditions. Failure to parenthesize correctly can lead to incorrect 
operation. 

3.2.1 Variable and Constant Names 

Local variable names should be unique to eight characters. Global variable names 
and procedure names should be unique to six characters. All variable and procedure 
names should be completely lower-case. 

Usually, names defined with a #define statement should be entirely upper-case. The 
only exceptions are functions defined as macros, such as getc and isascii. These names 
should also be unique to eight characters. 

You should not redefine global names as local variables within a procedure. 

3.2.2 Variable Typing 

Using standard types is unsafe in programs designed to be portable due to the 
differences in C compiler standard type definitions. Instead, use a set of types and storage 
classes defined with typedef or #define. The following tables define C language types 
and storage classes. 
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Table 3-1. Type Definitions 


Type 

C Base Type 

LONG 

signed long 

(32 bits) 

WORD 

signed short 

(16 bits) 

UWORD 

unsigned short 

(16 bits) 

BOOLEAN 

short 

(16 bits) 

BYTE 

signed char 

(8 bits) 

UBYTE 

unsigned char 

(8 bits) 

VOID 

void (function return) 


DEFAULT 

int 

(16/32 bits) 


Table 3-2. Storage Class Definitions 


Class 

C Base Class 

REG 

register variable 

LOCAL 

auto variable 

MLOCAL 

module static variable 

GLOBAL 

global variable definition 

EXTERN 

global variable reference 


Additionally, you must declare global variables at the beginning of the module. Define 
local variables at the beginning of the function in which they are used. You must always 
specify the storage class and type, even though the C language does not require this. 

3.2.3 Expressions and Constants 

Write all expressions and constants to be implementation-independent. Always use 
parentheses to avoid ambiguities. For example, the construct 


if(c = getcharQ = = ‘\n’) 


does not assign the value returned by getchar to c. Instead, the value returned by getchar 
is compared to ‘\n’, and c receives the value 0 or 1 (the true/false output of the 
comparison). The value that getchar returns is lost. Putting parentheses around the 
assignment solves the problem: 

if((c = getcharQ) = = ‘\n’) 
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Write constants for masking, so that the underlying int size is irrelevant. In the 
following example, 

LONG data; 


printf("Xld/n" » ( d a t a & OxffffL) i 

the long masking constant solves the previous problem for all compilers. Specifying 
the one’s complement often yields the desired effect, for example, "Oxff instead 
of OxffOO. 

For portability, character constants must consist of a single character. Place multi- 
character constants in string variables. 

Commas that separate arguments in functions are not operators. Evaluation order is 
not guaranteed. For example, the following function call 

printf("Xd Xd\n " ♦ i++ # i ++ ) » 

can perform differently on different machines. 

3.2.4 Pointer Arithmetic 

Do not manipulate pointers as ints or other arithmetic variables. C allows the addition 
or subtraction of an integer to or from a pointer variable. Do not attempt logical 
operations, such as AND or OR, on pointers. A pointer to one type of object can convert 
to a pointer to a smaller data type with complete generality. Converting a pointer to a 
larger data type can yield alignment problems. 

You can test pointers for equality with other pointer variables and constants, notably 
NULL. Arithmetic comparisons, such as > = , do not work on all compilers and can 
generate machine-dependent code. 

When you evaluate the size of a data structure, remember that the compiler might 
leave holes in a data structure to allow for alignment. Always use the sizeof operator. 
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3.2.5 String Constants 

Allocate strings so that you can easily convert programs to foreign languages. The 
preferred method is to use an array of pointers to constant strings, which is initialized 
in a separate file. This way, each string reference then references the proper element of 
the pointer array. 

Never modify a specific location in a constant string, as in the following example: 
BYTE strin*[3 ="BDOS Error On x : " » 


st rin *E 142 = ' A ' i 

Foreign-language equivalents are not likely to be the same length as the English version 
of a message. 

Never use the high-order bit of an ASCII string for bit flags. Extended character sets 
make extensive use of the characters above 0x7F. 

3.2.6 Data and BSS Sections 

Usually, C programs have three sections: text (program instructions), data (initialized 
data), and BSS (uninitialized data). Avoid modifying initialized data if at all possible. 
Programs that do not modify the data segment can aid the swapping performance and 
disk utilization of a multiuser system. 

Also, if a program does not modify the data segment, you can place the program in 
ROM with no conversion. This means that the program does not modify initialized static 
variables. This restriction does not apply to the modification of initialized automatic 
variables. 
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3.2.7 Module Layout 

The following list tells you what to include in a module. 

■ At the beginning of the file, place a comment describing the following items: 

— the purpose of the module 

— the major outside entry points to the module 

— any global data areas that the module requires 

— any machine or compiler dependencies 

■ Include file statements. 

■ Module-specific #define statements. 

■ Global variable references and definitions. Every variable should include a 
comment describing its purpose. 

■ Procedure definitions. Each procedure definition should contain the following 
items: 

— A comment paragraph, describing the procedure’s function, input parameters, 
and return parameters. Describe any unusual coding techniques here. 

— The procedure header. The procedure return type must be explicitly specified. 
Use VOID when a function returns no value. 

— Argument definitions. You must explicitly declare storage class and variable type. 

— Local variable definitions. Define all local variables before any executable 
code. You must explicitly declare storage class and variable type. 

— Procedure code. • 

Refer to Appendix C for a sample program. 
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Appendix A 

Summary of BIOS Functions 


Table A-l lists the BIOS functions supported by CP/M-68K. For more details on these 
functions, refer to the CP/M-68K Operating System System Guide. 


Table A-l. Summary of BIOS Functions 


Function 

F# 

Description 

Init 

0 

Called for Cold Boot 

Warm Boo. 

1 

Called for Warm Stan 

Const 

2 

Check for Console Character Ready 

Conin 

3 

Read Console Character In 

Conout 

4 

Write Console Character Out 

List 

5 

Write Listing Character Out 

Auxiliary Output 

6 

Wr i te Ch a racter to Auxiliary Output Devi ce 

Auxiliary Input 

7 

Read from Auxiliary Input Device 

Home 

8 

Move to Track 00 

Seldsk 

9 

Select Disk Drive 

Settrk 

10 

Set Track Number 

Setsec 

11 

Set Sector Number 

Setdma 

12 

Set DMA Offset Address 

Read 

13 

Read Selected Sector 

Write 

14 

Write Selected Sector 

Listst 

15 

Return List Status 

Sectran 

16 

Sector Translate 

Get Memory Region 
Table Address 

18 

Address of Memory Region Table 

Get I/O Byte 

19 

Get I/O Mapping Byte 

Set I/O Byte 

20 

Set I/O Mapping Byte 

Flush Buffers 

21 

Writes Modified Buffers 

Set Exception Vector 

22 

Sets Exception Vector 


End of Appendix A 
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Table A-l. (continued) 


Number 

Name 

Error Message 

21 

- 

Error Undefined on CP/M-68K 

22 

EINOAL 

Invalid argument 

23 

ENFILE 

File table overflow 

24 

EMFILE 

Too many open files 

IS 

ENOTTY 

Not a typewriter 

26 

- 

Error Undefined on CP/M-68K 

27 

EFBIG 

File too bitf 

28 

ENOSPC 

No space left on device 

29 

- 

Error Undefined on CP/M-68K 

30 

E.R0FS 

Read-Only file system 

31 

- 

Error Undefined on CP/M-68K 

32 

- 

Error Undefined on CP/M-68K 

33 

- 

Error Undefined on CP/M-68K 

34 

- 

Error Undefined on CP/M-68K 

35 

ENODSPC 

No directory space 


The file <errno.h> also includes the names for all errors defined with UNIX V7. 
Therefore, programs that reference these definitions need not be changed. 


End of Appendix A 
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Customizing the C Compiler 


Compiling a C program requires three compiler passes. The output of the compiler 
is assembly language, which must be assembled and linked to produce a program that 
runs. The compiler, assembler, linker load modules, C library, and the system include 
files need a substantial amount of disk storage space, minimizing storage space. This 
appendix discusses compiler operation and suggests ways to minimize the disk storage 
requirements for compiling. 


B.l Compiler Operation 

The C compiler has three components: the preprocessor (CP68), the parser (C068), 
and the code generator (Cl 68). The assembler (AS68) and the linker (LO68) also help 
generate an executable program. The following list tells you how these components 
operate. 

1. The preprocessor, CP68, takes the original source file and produces a file with 
all #define and #indude statements resolved. The preprocessor command line 
takes the form: 

CP68 [-1 d:J file.C file.I 

The -I flag indicates that the next argument is a CP/M-68K drive specification. 
This drive is used for all library include statements of the form #include <file>. 
Drive specifications can also appear in the filename portion of an #include 
statement, but this procedure is not recommended. File.C is the source file, and 
file.I is the output file. 

2. The parser, C068, takes the file produced by the preprocessor and creates an 
intermediate code file. The command line takes the form: 

C068 filed file.IC file.ST 

Filed is the output from the preprocessor. File.IC is the intermediate code file 
that Cl 68 uses. File.ST is a temporary file that collects constant data for 
inclusion at the end of the intermediate code file. 
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3. The code generator, Cl 68, takes the intermediate code file from C068 and 
produces an assembly-language source file. The command line takes the form : 

Cl 68 file.IC file.S [-LD] 

File.IC is the intermediate code output from C068. File.S is the assembly- 
language output file. The -L flag indicates that the compilation assumes all 
address variables are 32 bits. The default is 16-bit addresses. The -D flag causes 
the compiler to include the line numbers from the source file (file.C) as com- 
ments in the generated assembly language. This is useful for debugging. 

4. The assembler, AS68, translates the compiler output to a form that the linkage 
editor can use. The command line takes the form: 

AS68 -L -U [-F d:] [-S d:] file.S 

The -L option indicates to the linkage editor that addresses are considered 32-bit 
quantities. The -U option means that undefined symbols are considered external 
references. The -F option specifies a drive that the assembler uses for temporary 
files. The -S option specifies a drive that the assembler uses for the initialization 
file (AS68SYMB.DAT). File.S is the output of Cl 68, and file.O is produced by 
the assembler. 

5. The linker, LO68, produces an executable file from the output of one or more 
assembler runs. You must also include a start-up file and die C library when 
linking C programs. The linker command line takes the form: 

LO68 -R [-F d:] -O file.68K S.O file.O clib 

The -R option specifies that the file be relocatable. Relocatable files run on any 
CP/M-68K system. The -F option allows you to place linker temporary files on 
a disk drive other than the default. The -O file.68K construct makes the linker 
place the executable output in file.68K. S.O is the run-time start-up routine. 
You must include this file as the first file in every C program link. File.O is the 
output of the assembler. Specify multiple files between S.O and clib if you want 
separate compilation, clib is the C library file. 
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B.2 Supplied submit Files 

CP/M-68K includes two submit files, c.sub and clink. sub, that compile and link C 
programs (see Section 1.1). Usually, these files are located on the default drive. However, 
you can edit these files to specify different disk drives for any of the following drives: 

■ The disk drive on which the compiler passes, assembler, and linker reside. 

■ The disk drive that the #include <file> statements in the C preprocessor 
reference. 

■ The disk drive with the assembler initialization file. 

■ The disk drive on which the assembler and linker create temporary files. 

■ The disk drive containing the C library file. 


B.3 Saving Disk Space 

You can do the following things to conserve disk space: 

■ Use the reloc utility on all the load modules, the compiler, assembler, linker, and 
editor. This significantly reduces file size and load time. 

■ Place all the load modules on one disk and use another disk for sources and 
temporary files. This requires two drives. 

■ On single-density disk systems, you must place the C library file and linker on 
a separate disk and swap disks before linking. 
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B.4 Gaining Speed 

Along with the items in Section B.3, you can speed compilation by implementing the 
following: 

■ Put the assembler temp files on a different drive from the source and object files. 

■ Put the linker temp files on a different drive from the object input, C library, and 
load module output. 

■ Use the linker -S (suppress symbol table) and -T (absolute load module) switches 
in place of the -R flag. If you do this, the resulting program cannot run on an 
arbitrary CP/M-68K system. 

End of Appendix B 
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Sample C Module 


The 'nodules in this appendix are written and documented in C code ihat follows the 
style conventions discussed in Section 3. 


/* 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/# 

/* 

/# 

/# 

/# 

/* 

/» 

/» 

/« 

/» 

/* 

/* 

/# 

/* 

/♦ 

/* 

/* 

/* 

/* 

/♦ 

/* 

/* 

/* 

/* 

/* 

/* 

/# 

/* 

/♦ 


Printf Module 


This module is called through the single entry point ".printf" to 
perform the conversions and output for the library functions: 

printf - Formatted print to standard output 
fprintf - Formatted print to stream file 
sprintf - Formatted print to strinS 

The callins routines are logically a part of this module> but are 
compiled separately to save space in the user's prosram when only 
one of the library routines is used. 

The following routines are present: 


-printf 
_p rnt8 
_prntx 

c env 

_putst r 
_prntl 


Internal printf conversion / output 
Octal conversion routine 
Hex conversion routine 
Decimal ASCII to binary routine 
Output character to string routine 
Decimal conversion routine 


The following routines are called: 


st rlen 
putc 
f toa 


Compute length of a string 
Stream output routine 

Floating point output conversion routine 


This routine depends on the fact that the argument list is always 
composed of LONG data items. 


Configured for Whitesmith's C on VAX. 
reversed from UNIX. 


1 putc " arguments are 


*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
#/ 
*/ 
*/ 
*/ 
*/ 
• / 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
♦ / 
*/ 
*/ 
*/ 
*/ 
*/ 
#/ 
*/ 
*/ 


/♦ 

*/ 

•include 


Include files: 


<stdio.h> 


/• Just the standard stuff */ 
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/* 

• Local DEFINES 

*/ 

•define HIBIT 31 


/* 

# Local static data: 

♦ / 

MLOCAL BYTE *_Ptrbf - Oi 

HLOCAL BYTE *_ptrst = Oi 

MLOCAL BYTE fait z Oi 


/• HiJh bit number of LONG •/ 


/»#*#*##*#*****•«#*»#*#******/ 
/• Buffer .Pointer */ 

/• -> File/strin* (if any) */ 

/» Format Pointer */ 

/•#**•***•**«#*•*•*«•****••**/ 
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fj 


* 

* PRINTF INTERNAL ROUTINE 


Routine “_printf“ is used to handle all "printf" functions) includins 
"sprintf'i and "fprintf". 


Cal 1 ins Sequence: 


_printf(fd > f unc if mt >arsl ) i 


Uhe re : 


fd 

Is 

the 

file or 

s t r i n s 

pointer. 

f un c 

Is 

the 

function 

t 0 

handle output . 

f mt 

Is 

the 

address 

of 

the 

format strins 

arsl 

Is 

the 

address 

0 f 

the 

first a r S . 


Returns: 


Number of characters output 


Buss : 

It is assumed that arss are contisuous startins at "arsl-i and that 
all are the same size (LONG) i except for floatins point. 


♦♦♦♦♦♦*«*««4««*e**e**««*«*t#4*e*#4«t«*#»**«****e«*ee«***«*t*«»**«et»«**e«»*e*/ 
-printf (fd.f.fmt.al) / 44 444444444444444444444444444444/ 


LONG 

fd! 


/* Not really » but . . • 

• / 

LONG 

(♦fin 

i 

/* Function pointer 

♦ / 

BYTE 

*f mt ; 


/* -> Format strins 

• / 

LONG 

*al ; 


/♦ -> ArS list 

♦ / 




/♦♦♦♦•♦♦♦♦♦♦♦♦♦♦•♦♦«•♦♦♦#*♦•*•**♦/ 

LOCAL 

BYTE 

c 5 

/* Format character temp 

♦ / 

LOCAL 

BYTE 

♦ s i 

/* Output strins pointer 

♦ / 

LOCAL 

BYTE 

ad J 5 

/• Risht/left adjust flas 

♦ / 

LOCAL 

BYTE 

buf 130] I 

/* Temporary buffer 

♦ / 




/•XtSillfllittSittlltMIftllfitt/ 

LOCAL 

LONG 

♦ ad x 5 

/* Ars Address temporary 

♦ / 

LOCAL 

LONG 

x 5 

/♦ Ars Value temporary 

*/ 

LOCAL 

LONG 

n ? 

/♦ Strins Lensth Temp 

♦ / 

LOCAL 

LONG 

M i 

/* Field Lensth Temporary 

• / 

LOCAL 

LONG 

width? 

/* Field width 

• / 

LOCAL 

LONG 

prec 5 

/♦ Precision for “Zx.yf" 

♦ / 

LOCAL 

LONG 

padchar • 

/♦ 'O' or ' ' (paddins) 

♦ / 

LOCAL 

DOUBLE 

zz5 

/♦ Floatins temporary 

♦ / 

LOCAL 

DOUBLE 

♦dblptr! 

/• Floatins temp, address 

♦ / 

LOCAL 

LONG 

ccount 5 

/• Character count 

♦ / 

EXTERN 

.putstrl ) 5 

/* Reference function 

*/ 


/ 4444444 444444 44444444 4444 #♦ #«»*§/ 
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c c oun t - 0 ! 
-Ptrbf = bufi 
adx - alt 
-Ptrst - fdi 
fmt - fait! 


/* Initially no characters ♦ / 
/* Set buffer pointer */ 
/* Copy address uariable */ 
/* Copy file descriptor */ 
/• Copy format address */ 


if(*__fmt := 'L' 
f *lt + + 5 


~fmt = - '1 ' ) 


/* SKip Ion* output 
/* conversions 

/* 


/* This is the main format conversion loop. Load a character from the 
/• format strinf. If the character is '2'# perform the appropriate 
/* conversion. Otherwise# just output the character. 


*/ 
*/ 
♦ / 
*/ 
*/ 
*/ 
*/ 
*/ 


while! c = *__fmt++ ) 

{ 

i f 1 c ! = 'I') % 

i 

(«f ) t f d # c 1 i 
ccount++ 1 

> 

else 

I 

x z *adx++5 

i f ( * fmt == ) 

< 

ad j = ' 1 ' i 
f mt++ ! 

> 

else 

adJ : 'r' i 

padehar : <* fmt =s '0'> ? '0' 

width = __eonv ( ) 5 
if ( *__f mt == '. ') 

++ fmt 5 

p rec = con v ( ) i 

> 

else 

prec - 0. 
s = 0! 

switch ( c = * fmt++ ) 

i 

case 'O': 
case 'd ' : 

_p rt 1 ( x ) i 
break! 


/* */ 
/* Pick up next format char*/ 

/* */ 

/* */ 

/* If not '!'» Just output */ 
/* Dump character count •/ 

/* It is a 'I ' # #/ 

/* convert */ 

/* x - address of next ar* */ 


/•*••*•*••••«****•••****•«**/ 
/* Check for left adjust */ 

/•a***********************#*/ 
/* Is left# set fla* */ 

/• Dump format pointer * 

/* */ 

/• Risht adjust */ 

/•****#*•***«•*#«»*****»«**«/ 
/* */ 

'5 /* Select Pad character */ 

/*•***#**♦* •«**••«** ««•••**«/ 
/* Convert width (if any) */ 

/lilSttHHMIHHftliHtltl/ 

/* means precision spec*/ 


/* */ 
/* Dump past ' . ' */ 

/* Convert precision spec */ 
/* */ 
/* None specified */ 

/«**••**•***•***••• «••***•**/ 
/* */ 
/* Assume no output strins */ 
/* Next char is conversion */ 
/* */ 
/* Decimal */ 

/* */ 
/• Call decimal print rtn •/ 
/* Co do output */ 


/•**••***•***•••«•«•«••«•••«/ 
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cast 'o': 
case 'O': 

_prntB(x) i 
b reak S 

case 'x': 
case 'X': 

_prntx(x>5 
b reak i 

case 'S': 
case ‘s': 
s = x i 
b reak i 

case 'C': 
case 'c': 

*_ptrbf+* = X&0377 5 
b reakl 

case 'E': 
case 'e': 
case 'F': 
case 'f': 

dblptr = adx-1 5 
zz = edblptr? 
adx =+ i; 

ftoa (zz t buf * prec » c) ! 
prec - OS 
s = buf! 
break! 

default: 

(*f ) (fd tc ) ! 
ccount++5 
adx-- ! 


if (s :: 0) 

< 

e.ptrbf = 'O'* 
s = bufi 

> 


/s Octal */ 
/* Print «/ 
/« Call octal printer */ 
/* Go do output */ 
/a**************************/ 
/# Hex #/ 
/* Print »/ 
/• Call conuersion routine */ 
/* Go do output • / 
/**••***••*******••»***•**••/ 
/* Strins */ 
/* Output? */ 
/* Yes * ( easy ) */ 
/* Go finish up */ 
/***•*•*•*••«*•**•***••***••/ 
/* Character */ 
/* Output? */ 
/* Just load buffer */ 
/* Go output */ 
/***•*•*•****•****••*****•••/ 
/* Floatin* point? */ 
/# */ 
/* */ 
/* */ 
/* Assumes Bfl bit float! *1 
/* Load value */ 
/• Bump past second word */ 


/* Call floatins conversion*/ 
/* Fake out paddinS routine*/ 
/* Just like strins print */ 
/* Go Output */ 
/•*«•***»*•••••**•*••*•*****/ 
/• None of the above? •/ 
/* Just Output */ 
/* Count it. */ 
/* Fix ars address */ 
/* End switch */ 
/ •••***••«*••***•* •**••*•*••/ 
/* If s = 0* strins is in */ 
/* -buf. */ 
/• Insure termination •/ 
/• Load address •/ 
/••••••a******* ••***•••*••••/ 


n = st rl en ( s ) 5 

n = <prec<n U prec != 0) ? prec 
m = width-ni 

if ( adJ ; - ' r ' > 
while (m — > 0) 

{ 

<*f ) ( f d ipadchar) 5 
ccount++5 

} 


/* */ 

/* Compute converted lensth*/ 
nt/* Take min(prec>n) •/ 

/* m is • of pad characters*/ 

/••••••••ft******************/ 


/* For risht adjust* */ 
/* Pad in front */ 
/* */ 
/* Thusly */ 
/• Count it •/ 
/* «/ 


/**•*•••**•» ••«•••«**• •**•••/ 
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while ( n-- ) 

< 

(*f ) ( r d i«s++ ) ; 
ccount++ i 

> 

while ( »-- > 0 ) 

{ 

(*f ) ( f d >padcha r ) i 
ccount++ « 

> 

_Pt rbf s buf! 

> 

> 

1 f ( ( *f ) ; ; _PUtSt r ) 

(♦fXfd.'O') i 
return! ccount ) ? 


/* Output Converted */ 
/* */ 
/« Data «/ 
/* Count it */ 
/* */ 



/* If left adjust * «/ 
/* #/ 
/* Pad «/ 
/* Count padded characters */ 
/tMiitimituHiimitiHi/ 
/* Reset buffer pointer */ 
/• End else */ 
/* End while «/ 
/• If st rin* output < */ 
/* Drop in terminator char •/ 

/• Return appropriate ualuet/ 
/* End _printf */ 
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/«*«**••**••*****«*•«*«••••••**««**•*•«*••*«•***•*««#**»*•**•*•»***•****/ 

/* */ 
/* _ P R N T 8 PROCEDURE */ 


Routine *_prnt8" converts a binary LONG value to octal ascii. 
The area at "_ptrbf" is used. 

Calling Sequence: 

_prnt8(n) 5 

"n" is the number to be converted. 


Returns: 


(none ) 


/*e*****«**«*et***t ***«« ***•**«»*•*« «***•»**«*****#«****•*«**•***•*»**•*/ 
VOID _prntB (n) /* #/ 

LONG n! /* Number to convert */ 

< /* #/ 

REG WORD p? /* Counts bits */ 

REG WORD ki /* Temporary 3-bit value */ 

REG WORD suS /* Switch 1 = > output */ 


if <n == 0) 

< 

*_pt rbf ♦♦ = 'O'! 
return ? 

> 

sw = o; 

for (p=HIBIT5 p >= 05 p =- 3) 

if <(K = ( n > > p ) 8.07 ) sw) 

< 

if (p-rHIBIT) 

k = k & 025 
*_pt rbf ++ = 'O' + ki 
sw = i; 

> 


/* Number to convert */ 
/* #/ 
/* Counts bits */ 
/* Temporary 3-bit value */ 
/* Switch 1 z > output */ 

/• Handle 0 as special case*/ 
/* */ 
/• Put in one zero •/ 
/* And quit */ 
/* */ 
/••**••*•*#*•*********•••**•/ 
/• Indicate no output yet •/ 
/* »/ 
/* Use 3 bits at a time •/ 
/* e/ 
/* Need to output yet? */ 
/* #/ 
/• 1st disit has only 2 bits*/ 
/* Mask appropriately */ 
/* ASCI IfydiSit */ 
/* Set output flas */ 
/* End if */ 
/* End _prnt8 */ 
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/* */ 

/* _Prntx Function #/ 

/* ♦ / 

t* ♦ / 

/* The ,, _prntx ,, function converts a binary LONG Quantity to hex ASCII */ 

/* and stores the result in "*_Ftrbf". Leadins aeros are suppressed. */ 

'* ♦ / 

/* Callins sequence: */ 

t* ♦ / 

/* _f rn t x ( n ) i */ 

f* */ 

/* where ”n” is the value to be converted. */ 

'* #/ 

/♦Returns: «/ 

'* ♦/ 

/♦ ( none ) */ 

♦/ 

VOID _prntx (n) /* */ 

t LONG nS /♦ 32 bits ♦/ 


REG LONG d? 

REG LONG a ! 

if (a : n>>A) 

_prntx ( a & Oxfffffff)! 
d = n&017 i 

♦_Ptrbf++ : d > 9 ? 'A'+d-10 : 'O' 


/♦ 

A di sit 

♦ / 

/♦ 

T empo r a ry value 

♦ / 

/ttitittittKttttitteKmmtt/ 

/♦ 

Peel off low A bits 

♦ / 

/♦ 

If < > 0 » print f i rst 

♦ / 

/♦ 

TaKe low four bits 

♦ / 

+ d ;/♦ 

ASCI Ify into buffer 

♦ / 


/HHittllttHIHIIftHttttttt/ 
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t* */ 

/* -Putstr Function ♦/ 

t* */ 

/* */ 

/* Function “.putstr" is ustd by "sprintf* as the output function #/ 

/* a r Jument to "_printf". A sinsle character is copied to the buffer */ 

/* at "_ptrst“. */ 

t* */ 

t* Calling Sequence: •/ 

t* */ 

/* -Puts t r ( s t r ich r ) ! */ 

f* */ 

/* where "str" is a dummy argument necessary because the other output */ 

/* functions haue two ariuments. •/ 

t* */ 

/* Returns: */ 

t* */ 

/* (none) ' »/ 

/* #/ 


UOID _putst r ( st r »ch r ) 

REG BYTE chri 

BYTE *st r ? 

< 

*_ptrst++ = chri 
return(O) i 

> 


/* ♦/ 
/* The output character •/ 

/* Dummy argument */ 

/***•••**•***»*** «****# *•#•«*/ 
/* Output the character */ 

/* Go bacK */ 

/***••**••***•**«§ ***««*«* »#*/ 
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/# 

/* 

/* 

/* 

/* 

/* 

/* 

/* 

/• 

/* 

/• 

/* 

/* 

/* 

/* 

/* 

/• 
/*« 
VOID 

< 


_ P r t 1 Function 

Function "-prtl" converts a LONG binary quantity to decimal ASCII 
at the buffer pointed to by "_ptrbf“. 

Callin* Sequence: 

_p rt 1 ( n ) i 

where *n” is the value to be converted! 

Returns: 

(none) 


.prtl(n) 

REG LONG 

REG LONG 
REG LONG 

dpt s dies! 


n i 

dies! 15] ! 
*dPt 5 


if (n >r 0) 
n s -n 5 

else 

*_pt rbf ++ = ' 5 

for (! n !r 05 n r n/10) 
*dPt++ = nZIO; 

if (dpt -- dies) 

*dpt++ = 05 

while (dpt != dies) 

< 

— dPt 5 

*_pt rbf ♦♦ = '0' - *dpt 5 


#/ 
*/ 
• / 
*/ 
*/ 
*/ 
*/ 
*/ 
#/ 
*/ 
*/ 
*/ 
*/ 
»/ 
»/ 
• / 
t/ 


/* */ 
/* Conversion input */ 

/**•«•*•»•**•***••*«*•***•***/ 
/* store dieits here */ 

/* Points to last dieit */ 
/#*#***###**#*#«##**♦*******#/ 
/• Initialize diJit pointer */ 
/♦a#****#*#*#***## *«*»**♦****/ 
/* Fix */ 

/* up */ 

/* si»n */ 

/* stuff */ 

/**«•***•«*******•***••****•*/ 
/• Divide by 10 till zero */ 

/• Store difit (reverse ord)*/ 

/****#*******»**#»***«***•*♦#/ 
/» Zero value? */ 

/• Yes! store 1 zero dieit */ 
/•#******•*«* •*«*••«# tee*****/ 
/• Now convert to ASCII */ 

/* */ 

/• Decrement pointer */ 

/* Note disits are negative!*/ 
/* */ 

/•«•*»***»«**•••***••** t *»*•*/ 


End of Appendix C 
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Appendix D 
Error Messages 


This appendix lists the error messages returned by the components of the CP/M-68K 
C compiler, the C Parser, C068, the C Co-generator, Cl 68, the C Preprocessor, CP68, 
and by the CP/M-68K C Run-time Library. The sections are arranged alphabetically. 
Error messages are listed within each section in alphabetical order with explanations 
and suggested user responses. 


D.l C068 Error Messages 

CP/M-68K C Parser, C068, returns two types of error messages: diagnostic error 
messages and messages indicating errors in the internal logic of C068. Both types of 
error messages take the general form: 

*line no. error message text 

The asterisk (*) indicates that the error message comes from C068. The “error message 
text” describes the error. You must correct any errors you receive from C068 before 
invoking C168. Uncorrected errors from C068 cause erroneous error messages to occur 
when you run C168. 

D.1.1 Diagnostic Error Messages 

These error messages occur mostly in response to syntax errors in the source code. 
Refer to your C language manual for a complete discussion of the C language syntax. 

The error messages are listed in Table D-l in alphabetical order with short explana- 
tions and suggested user responses. 
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Table D-l. C068 Diagnostic Error Messages 


Message 

Meaning 

♦ line 

no< address of resister 

You have attempted to take the address of a register. Correct the 
source code before you recompile it. 

♦ line 

no. assignable operand required 

On the line indicated, the operand to the left of the equals sign in the 
assignment statement is not a valid operand. Supply a valid operand. 
This error might occur because the operand is a constant instead of a 


variable. 

♦ line 

no. bad character constant 

A character constant on the line indicated is invalid. The character 
constant must be a single character between quotes. A control charac- 
ter, more than one character, or a symbol that is not a character will 
cause this error to occur. 

♦ line 

no. b ad i n d i r e c t i on 

You attempted to reference by address instead of by value, but the 
expression you used is not an address. Supply a value or a valid address 
before you recompile the source code. 

♦ line 

no. can't open filename 

Either the filename or the drive code is incorrect. Specify the correct 
drive code and filename before you recompile the source code. 

♦ line 

no. case not inside a switch block 

The case on the line indicated is not inside a switch block. Correct the 
source code before you recompile it. 

♦ line 

no. character constant too lonS 

The character constant on the line indicated is too long. A character 
constant must be a single character between quotes. Correct the source 
code before you recompile it. 

♦ line 

no. constant required 

The operation on the line indicated requires a constant. Correa the 
error before you recompile the source code. 
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Table D-l. (continued) 


Message 


Meaning 

♦ line 

no « 

declaration syntax 



The syntax of the declaration on the line indicated is incorrect. Refer 
to your C language manual. Correct the syntax before you recompile 
the source code. 

♦ line 

n o . 

default not inside a switch blocK 

The default on the line indicated is not inside a switch block. Correct 
the source code before you recompile it. 

♦ line 

no. 

dimension table overflow 

There are too many dimensions, at or prior to the line indicated, for 
the dimension table. The dimension table does not have space for more 
than 8 or 9 dimensions. Structures count as dimensions. Rewrite the 
source code to use fewer dimensions and structures before you recom- 
pile it. 

♦ line 

no. 

duplicate case value 

Two cases for the same switch are identical. Eliminate one of the cases 
before you recompile the source code. 

♦ line 

no. 

expected 1 abel 

A go to statement on the line indicated does not have a label. Supply 
the missing label before you recompile the source code. 

♦ line 

n o • 

expression too complex 

Due to internal limitations in C068, the expression on the line indi- 
cated is too complex to be evaluated. Simplify the expression before 
recompiling the source code. 

♦ line 

n o . 

external definition syntax 

The syntax of the external definition on the line indicated is incorrect. 
Correct the syntax before you recompile the source code. Refer to 
your C language manual for the correct syntax. 

♦ line 

no. 

field overflows byte 

The bit field asks for more bits than fit in an 8-bit byte. Reduce the 
number of bits in the bit field before you recompile the source code. 
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♦line no. indirection on function invalid 


You attempted to use the indirection operator (*) on a function. 
Correct the source code before you recompile it. 
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Table D-l. (continued) 


Message 


Meaning 

♦ line 

n o « 

initializer alignment 



This message usually indicates a missing initializer value, or values 
out of order. Check the initializer list and correct it before you 
recompile the source code. 

♦ line 

n o • 

initializer list too Ion* 

The initializer list is too long for C068. Shorten the list before you 
recompile the source code. 

♦ line 

n o » 

invalid break statement 

The break statement on the line indicated is not inside a loop or a 
switch. Correa the source code before you recompile it. 

♦ line 

n o • 

invalid cha racte r 

There is an invalid charaaer in the collating sequence in the line 
indicated. Control charaaers or members of the extended charaaer 
set are not valid charaaers. Correa the source code before you 
recompile it. 

♦ line 

n o . 

invalid continue statement 

The continue statement on the line indicated is not inside a loop. This 
error might occur when you have used a continue statement in a 
switch. A continue statement is only valid in a loop. Correa the source 
code before reinvoking C068. 

♦ line 

n o . 

invalid conversion 

You attempted an incompatible assignment, for example, a pointer, 
32 bits, and an int, 16 bits. Correa the source code before you 
recompile it. 

♦ line 

n o . 

invalid datatype 

The line indicated contains an expression that attempts to equate two 
incompatible quantities, for example, an int, 16 bits, and a pointer, 
32 bits. Correa the source code before you recompile it. 
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Table D-l. (continued) 


Message 


Meaning 

♦ line 

n o , 

invalid declarator 

The declarator in the line indicated is not a recognizable language 
element. Supply a valid declarator before you recompile the source 
code. 

♦ line 

n o . 

invalid expression 

The expression in the line indicated contains a syntax error. Correct 
the syntax of the expression before you recompile the source code. 

♦ line 

n o . 

invalid field size 
* 

The field in the line indicated is less than or equal to zero. Correa the 
field size before you recompile the source code. 

♦ line 

n o . 

invalid field type description 

You attempted to put a pointer or a long into a bit field. Correa the 
source code before you recompile it. 

♦ line 

n o . 

invalid for statement 

The for statement in the line indicated contains a syntax error. Refer 
to your C language manual for the correa syntax of a for statement. 
Correa the statement before you recompile the source code. 

♦ line 

n o . 

invalid initializer 

The initializer you specified in the line indicated is not a constant. You 
can only initialize to a constant. Correa the source code before you 
recompile it. 

♦ line 

n o < 

invalid label 

You used a variable name as a label in the line indicated. Correa the 
source code before you recompile it. 

♦ line 

n o « 

invalid Ions declaration 

You attempted to declare something long that cannot be long, for 
example, a charaaer. Correa the source code before you recompile it. 
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Table D-l. (continued) 


Message 


Meaning 

♦ line 

n o . 

invalid operand type 

The expression in the line indicated contains an invalid operand. 
Correa the source code before you recompile it. 

♦ line 

n o . 

invalid resister specification 

You attempted to put something larger than allowed into a register, 
for example, a structure or a funaion. Correa the source code before 
you recompile it. 

♦ line 

n o . 

invalid short declaration 

You attempted to declare something short that cannot be short. 
Correa the source code before you recompile it. 

♦ line 

n o « 

invalid storage class 

You specified an invalid storage class in a declaration. Refer to your 
C language manual for the allowed storage classes. Correa the source 
code before you recompile it. 

♦ line 

n o « 

invalid structure declaration: name 

The size of the structure indicated by the variable name has a size 
less than or equal to zero. Correa the source code before you recom- 
pile it. 

♦ line 

no « 

invalid structure member name 

The structure reference in the line indicated is not a member of any 
structure. Correa the source code before you recompile it. 

♦ line 

n o . 

invalid structure prototype: name 

In the line indicated you reference a structure name that is not a 
prototype. Correa the source code before you recompile it. 

♦ line 

n o . 

invalid type declaration 

The type declared in the line indicated is invalid. Refer to your C 
language manual for a discussion of valid types. Correa the source 
code before you recompile it. 


E DIGITAL RESEARCH" 


D-7 




D.l C068 Error Messages C Language Programming Gnide 


Table D-l. (continued) 


Message 

Meaning 

♦ line 

no. invalid typedef statement 

The line indicated contains a statement with more than one typedef 
keyword. Only one typedef is allowed per statement. Correct the 
source code before you recompile it. 

♦ line 

no. invalid unsigned declaration 

The quantity you declared unsigned in the line indicated might not be 
unsigned. Only an int can be unsigned. Correa the declaration before 
you recompile the source code. 

♦ line 

no. invalid?': operator syntax 

This message indicates an error in the use of the ?: conditional operator 
in the line indicated. Refer to your C language manual for the correa 
syntax. Correa the source code before you recompile it. 

♦ line 

no. label redeclaration: label 

You used the same label for two separate items. Correa the source 
code before you recompile it. 

♦ line 

no . missinS colon 

You left out a colon. Supply a colon in the correa location before you 
recompile the source code. 

♦ line 

no. mi s s i n s -C in in i t i a 1 i z at i on 

You negleaed to put in the left curly brace in the initialization of an 
array or structure. Supply the missing brace before you recompile the 
source code. 

♦ line 

no. mi ssins > 

You left the right curly brace out of the initialization of an array or 
structure. Supply the missing brace before you recompile the source 
code. 

♦ line 

no. mi s s in * while 

The do statement at the line indicated is missing a while at the end. 
Supply the missing while before you recompile the source code. 
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D.l C068 Error Messages 


Table D-l. (continued) 


Message 


Meaning 

♦ line 

n o « 

missing semicolon 



A semicolon is missing from the line indicated. Supply the missing 
semicolon before you recompile the source code. 

♦ line 

n o 4 

no structure name 

You referred to a structure in the line indicated without giving the 
structure name. Correct the source code before you recompile it. 

♦ line 

n o 4 

no */ before EOF 

The list comment in the source code is missing its final delimiter. 
Supply the missing delimiter before you recompile the source code. 

♦ line 

n o 4 

not a structure: name 

The structure referenced in the line indicated is not a structure. Correct 
the source code before you recompile it. 

♦ line 

no 4 

not in parameter list: x 

In the line indicated, you declared the something indicated by the 
variable k to be an argument to a function, but x is not in the function 
parameter list. Correct the source code before you recompile it. 

♦ line 

n o 4 

parenthesized expression syntax 

The line indicated contains a syntax error in the parenthesized expres- 
sion. Correct the source code before you recompile it. 

♦ line 

n o 4 

redeclaration: symbol 

A symbol has been declared twice. Remove one of the declarations 
before recompiling the source code. 

♦ line 

n o 4 

strin* cannot cross line 

The character string at the line indicated continues beyond one line. 
The closing quote to a character string must be on the same line as 
the opening quote, unless you use a backslash (\) at the end of the 
first line to indicate that the line continues. Correct the source code 
before you recompile it. 
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Table D-l. (continued) 

Message Meaning 

♦line no. strini too loni 

The string at the line indicated is longer than 255 characters. A string 
cannot be longer than 255 characters on a single line. Break the string 
and use a continuation, indicated by a backslash (\) at the end of the 
line to be continued. 

♦ line no. structure declaration syntax 

The syntax of the structure declaration on the line indicated is incor- 
rect. Correct the syntax before reinvoking C068. 

♦ line no. structure' operation not yet implemented 

On the line indicated, you assigned a structure to another structure. 
Assigning a structure to another structure is not yet supported by the 
CP/M-68K C compiler. Correct the source code before reinvoking 
C068. 

♦line no. structure table overflow 

There are too many structures in your program for the structure 
tables. Eliminate some structures before reinvoking the C compiler. 

♦ line no. symbol table overflow 

Your program uses too many symbols for the space available on the 
symbol table. Eliminate some symbols before reinvoking the C 
compiler. 

♦ line no. temp creation error 

The drive code or filename of the temporary file referenced in the line 
indicated is incorrect. Specify the correct drive code and filename 
before you recompile the source code. 

♦ line no. too many cases in switch 

The switch at the line indicated has too many cases. Eliminate some 
cases before you recompile the source code. 
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D.l C068 Error Messages 


Table D-l. (continued) 


Message 


Meaning 

♦ line 

n o . 

too many initializers 

The initializer list in the line indicated contains more initializers than 
there are members of the array being initialized. Correa the list before 
you recompile the source code. 

♦ line 

n o < 

too many pa rams 

The function declaration at the line indicated contains too many 
parameters. Rewrite the source code before you recompile the source 
code. 

♦ line 

n o • 

undefined label: label 

The label indicated by the variable label has not been defined. 
Correa the source code before you recompile it. 

♦ line 

n o < 

undefined symbol: symbol 

The symbol indicated by the variable symbol is undefined. Correa 
the source code before you recompile it. 

♦ line 

n o t 

unexpected EOF 

This error usually occurs when there is no right curly brace (}) after 
a function, or when there are mismatched comment delimiters. Locate 
and correa the error before you recompile the source code. 

♦ line 

n o « 

usade: cOSB source asm str 

The syntax of the C compiler command line is incorrea. The correa 
syntax is given in the error message. Reenter the command line using 
a valid syntax. 

♦ line 

n o « 

{ not matched by > 

A left curly brace ({) is not matched by a right curly brace. This error 
frequently occurs in an initialization sequence. Supply the missing 
brace before you recompile the source code. 
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Table D-l. (continued) 

Message Meaning 

•line no. = " char" assumed 

You have user a = + type operation with an invalid character. When 
an invalid character occurs after the = sign, C068 puts in = = instead 
of = . Correct the source code before you recompile the source code. 

• line no. & operand illegal 

You attempted to take the address of something that is not a variable, 
for example, a register. Correct the source code and recompile it. 


D.l. 2 Internal Logic Errors 

These messages indicate fatal errors in the internal logic of C068: 


• line 

no . 

can't co 

• line 

n o • 

invalid 

• line 

n o . 

too many 

• line 

n o . 

too many 


pv filename 
Keyword 

chars pushed back 
tokens pushed back 


Contact the place you purchased your system for assistance. Provide the following 
information: 


■ Indicate the version of the operating system you are using. 

■ Describe your system’s hardware configuration. 

■ Provide sufficient information to reproduce the error. Indicate which program 
was running at the time the error occurred. If possible, also provide a disk with 
a copy of the program. 
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D.2 Cl 68 Error Messages 

The CP/M-68K C Co-generator, Cl 68, returns two types of fatal error messages: 
diagnostic error messages and messages indicating errors in the internal logic of C168. 
Both types of error messages take the general form: 

* *line no. error message text 

The asterisks (* *) indicate that the error message comes from C168. The error message 
text describes the error. If you run Cl 68 before correcting any errors you received from 
C068, you receive erroneous errors from C168. 

D.2.1 Fatal Diagnostic Errors 

The C168 fatal, diagnostic error messages are listed in Table D-2 in alphabetical 
order, with explanations and suggested user responses. 


Table D-2. C168 Fatal Diagnostic Errors 

Message Meaning 

**line no. can't create filename 

Either the drive code or the filename for the file indicated by the 
variable filename is incorrect. Ensure that you are requesting the 
correct drive code and filename before you recompile the source code. 

**line no. can't open f ilenane 

Either the drive code or the filename for the file indicated by the 
variable filename is incorrect. Ensure that you are requesting the 
correct drive code and filename before you recompile the source code.' 

**line no. divide by zero 

You attempted to divide by zero in the line indicated. Correct the 
source code before you recompile it. 

**line no. expression too complex 

An expression on the line indicated is too complex for C168. Simplify 
the expression before you recompile the source code. 
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Table D-2. (continued) 

Message Meaning 

♦ ♦line no. modulus bv zero 

The second operand of the percent operator in the line indicated is 
zero. Correa the source code before you recompile it. 

♦ ♦line no. structure operation not implemented 

The operation you attempted with a struaure in the line indicated is 
illegal. Correa the source code before you recompile it. 

♦♦line no. usa3e: clB8 icode asm C-DLmec3 

The command line syntax is incorrea. The correa command line 
syntax is given in the error message. Correa the syntax before you 
reenter the command line. 


D.2.2 Internal Logic Errors 

The following messages indicate fatal errors in the internal logic of 068: 
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If you receive one of these messages, contaa the place where you purchased your system 
for assistance. Provide the following information: 

■ Indicate the version of the operating system you are using. 

■ Describe your system’s hardware configuration. 

■ Provide sufficient information to reproduce the error. Indicate which program 
was running at the time the error occurred. If possible, also provide a disk with 
a copy of the program. 
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D.3 CP68 Error Messages 

The CP/M-68K C Preprocessor, CP68, returns rwo types of fatal error messages: 
diagnostic error messages and messages indicating errors in the internal logic of CP68. 
Both types of error messages take the general form: 

# line no. error message text 

The pound sign (#) indicates that the error message comes from CP68. The “error 
message text” describes the error. 

D.3.1 Diagnostic Error Messages 

A fatal diagnostic error message prevents CP68 from processing your file. The CP68 
diagnostic error messages are listed in Table D-3 with explanations and suggested user 
responses. 


Table D-3. CP68 Diagnostic Error Messages 
Message Meaning 

#line no. arsument buffer overflow 

An argument list in the line indicated contains too many characters 
for the space allocated to the argument buffer. Reduce the number of 
characters in the argument list before rerunning CP68. 

• line no. bad argument: ard 

In the line indicated, the argument represented by the variable a r 3 
contains an invalid character. Replace or eliminate the invalid charac- 
ter before rerunning CP68. 
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Table D-3. (continued) 

Message Meaning 

• line no. bad character octal no. 

The line indicated contains an illegal character. The ASCII code of the 
invalid character is represented by the variable octal no. Examine 
the line indicated to locate the error. Replace the character before 
rerunning CP68. 

• line no. bad define name: name 

The name indicated by the variable name contains one or more 
invalid characters. Examine the name to locate the error. Replace the 
invalid characters before rerunning CP68. 

• line no. bad include file 

The syntax of the •include statement is incorrect. The •include 
statement must follow one of the following two formats: 

#include <filename> 

#indude “filename” 

Rewrite the statement before rerunning CP68. 

• line no. bad include file name 

In the line indicated, the filename in the •include statement con- 
tains either an invalid character or more than 8 characters, the 
maximum allowed. Supply a valid filename before rerunning CP68. 

• line no. can't open fname 

The •include statement in the line indicated contains an invalid 
or nonexistent filename. Check the filename before rerunning CP68. 

• line no. can't open infile 

CP68 cannot open the input file indicated by the variable i n f i 1 e. 
Either the drive code or the filename is incorrect. Check the drive code 
and the filename before rerunning CP68. 

• line no. can't open outfile 

CP68 cannot open the output file indicated by the variable outfile. 
Either the drive code is incorrect, or the disk to which CP68 is writing 
is full. Check the drive code. If it is correct, the file is full. Erase 
unnecessary files, if any, or insert a new disk before rerunning CP68 . 
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Table D-3. (continued) 

Message Meaning 

»line noi condition stack overflow 

The source code contains too many nested #if’s for the space allocated 
to the condition stack. The stack overflowed before the line indicated. 
Rewrite the source code before rerunning CP68. 

• line no. define recursion 

A name or variable on the line indicated has been defined in terms of 
itself. Redefine the name before rerunning CP68. 

• line no. define table overflow 

The source code contains one or a combination of the following: too 
many names, too many long names, too many expressions, or too 
many large expressions. The space allocated to the define table was 
filled before the line indicated. Simplify and rewrite the source code 
before rerunning CP68. 

Mine no. expression operator stack overflow 

An expression in the line indicated contains too many operations for 
the space allocated to the expression operator stack. Eliminate or 
consolidate some operations before rerunning CP68. 

• line no. expression stack overflow 

An expression in the line indicated contains too many terms for the 
space allocated to the expression stack. Eliminate or consolidate some 
terms before rerunning CP68. 

• line no. expression syntax 

The syntax of an expression in the line indicated is incorrect. Examine 
the line to locate the error. Correa the syntax before rerunning CP6 8 . 

• line no . includes nested too deeply 

The •include statement in the line indicated contains more than 
7 nested include files, the maximum allowed. Rewrite the source code 
so that no one ^include statement contains more than 7 nested 
include files. 
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Table D-3. (continued) 


Message 


Meaning 

• line 

n o • 

invalid •else 

A •else statement occurs in the source code without a preceding 

• if statement. Supply the missing • i f statement or eliminate the 

• else statement before rerunning CP 68 . 

• line 

n o « 

invalid «endif 

A • e n d i f statement occurs in the source code without a preceding 
• if statement. Supply the missing • i f statement or eliminate the 
« e n d i f statement before rerunning CP 68 . 

• line 

n o . 

% 

invalid preprocessor command 

The command in the line indicated is either not valid for CP 68 or is 
incorrectly formatted. Correct the command before rerunning CP 68 . 

• line 

n o 4 

line overflow 

The line indicated contains more than 255 characters, the maximum 
allowed. Reduce the line to no more than 255 characters before 
rerunning CP 68 . 

• line 

n o 4 

macro argument too Ion S 

An argument name in the line indicated contains more than 8 charac- 
ters, the maximum allowed. Use no more than 8 characters for the 
argument name, and rerun CP 68 . 

• line 

n o 4 

no */ before EOF 

A comment in the source code is missing the closing */. Supply the 
missing */ before rerunning CP 68 . 

• line 

n o 4 

string cannot cross line 

A string in the line indicated is missing a closing quotation mark. 
Supply the missing quotation mark before rerunning CP 68 . 

• line 

n o 4 

st ring too long 

The line indicated contains a string greater than 255 characters, the 
maximum allowed. Shorten the string to no more than 255 characters 
before rerunning CP 68 . 
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Table D-3. (continued) 


Message 


Meaning 


•line no. symbol table ouerf low 

The source code uses too many symbols for the space allocated to the 
symbol table. The symbol table was filled prior to the line indicated. 
Eliminate some symbols before rerunning CP68. 


• line no. too many arsuments 

One of the names in the line indicated contains more than 9 arguments, 
the maximum allowed. Reduce the number of arguments to no more 
than 9 per name before rerunning CP68. 


• line no. unexpected EOF 

This message indicates an incomplete program. Examine the source 
code to locate the error. Correct before rerunning CP68. 


•line no. unmat c h ed c on d i t i on al 

A • i f statement occurs in the source code without a matching 
• e n d i f statement. Supply the missing • e n d i f statement before 
rerunning CP68. 

• line no. usade: cB8 C-i x : ] inputfile outputfile 

This message indicates incorrect syntax in the command line. The 
correct syntax is given. Correct the command line before rerunning 
CP68. Refer to your C manual for an explanation of the command 
line syntax. 
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D.3. 2 Internal Logic Errors 

CP68 returns only one message indicating an error in the internal logic of CP68: 

• line no. too many characters pushed back 

If you receive this message, contact the place where you purchased your system for 
assistance. Provide the following information: 

■ Indicate the version of the operating system you are using. 

■ Describe your system’s hardware configuration. 

■ Provide sufficient information to reproduce the error. Indicate which program 
was running at the time the error occurred. If possible, also provide a disk with 
a copy of the program. 


D.4 C-Run-time Library Error Messages 

The C-Run-time Library returns only one fatal error message, stack overflow. The 
stack overflow message means the program you are trying to include in the C-Run-time 
Library is too big. Reduce the size of the program. 


End of Appendix D 
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binary and ASCII files, 
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binary, 
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bit flags, 3-6 
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blank padding, 2-43, 2-50 
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buffer flushing, 2-18 
BUSERR, 2-53 
BYTE, 3-4 

byte order, 2-29, 2-44 

byte stream, transferring, 2-27 

C 
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C Co-generator, D-l 
C language, 

functions implemented in, 2-2 
portability, 3-1 
program memory layout, 1-1 
program compiling, 1-1 
c operator, 2-43, 2-51 
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C Preprocessor, D-l 
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character string, 2-51 
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CHK instruction, 2-53 
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chown function, 2-10 
clearerr function, 2-22 
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close function, 2-11 
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CO 68 , B-l , D-l 
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mandatory, 3-2 
suggested, 3-8 
code generator, B-l, B-2 
command line interface, 1-5 
commas, 3-5 

comments in a module, 3-7 
comparing two elements, 2-47 
compilation, speeding, B-4 
compiler, B-l, B-2, B-3, B-4 
compiler-generated code, 1-5 
compiling a C program, 1-1 
completion code, 2-18 
compound statement, 3-8 
CON:, 1-5, 2-35, 2-63 
concatenating strings, 2-57 
console device, 2-28, 2-35 
contiguous digits, 2-6 
control characters, 2-14 
control string format, 2-50 
controlling statement, 3-8 
conversion character, 2-50 
conversion code, capitalized, 
2-43 

conversion operators, 2-42 
optional instructions in. 

2-43 

conversion specifications, 2-50 
copying strings, 2-59 
COS function, 2-12 
CP68 , B-l 

CP/M-68K C compiler, D-l 
CP/M-68K C Run-time Library, 

D-l 

creat function, 2-11, 2-13 
creata function. 2-13 
creatb function, 2-13 
CTRL-Z. 1-6 
ctype function, 2-14 
<ctype.h> file, 2-14 


D 

-D flag, B-2 
d character, 2-51 
d operator, 2-43 
data, 

conversion, 2-2 
region, 2-16 
structures, 3-1 
DDT-68K, 2-3 
decimal ASCII, 2-43 

integer conversion, 2-51 
DEFAULT, 3-4 
default drive, B-3 
♦define statement, 3-3, B-l 
module -specific, 3-7 
deleting a file, 2-65 
destination string, 2-59 
/dev/lp, 1-5 
/dev/tty, 1-5 

device access, terminating, 
2-11 * 
device I/O, 1-5 
digit string, 2-43 
disk space, conserving, 

B-l , B-3 

disks, swapping, B-3 
do, 3-8 

documenting code, 3-8 
drive changing, B-3 
dynamic memory allocation, 2-1 
dynamic memory areas, 
heap, 1-2 
stack, 1-2 

E 

E2BIG, A-l 
EACCES, A-l 
EBADF, A-l 

edata location, 1-2, 2-16 

editor, B-3 

EFBIG. A- 2 

EINVAL. A- 2 

EIO, A-l 

else, 3-8 

end, 1-2 

end location, 2-16 
end-of-file, 2-22 
errors, 2-30 
ENFILE, A-2 
ENODSPC , A-2 
ENOENT, A-l 
ENOMEN, A-l 
ENOSPC, A-2 
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ENOTTY, A- 2 
entry points, 2-2 
EROFS, A-2 

errno external variable. 
2-40, A-l 

<er rno.h>include file, A-l 
error, 

in specified stream, 2-22 
system-dependent, 2-3 
error file, 2-40 
err or messages, numbers, 
2-40, A-l 

error return, from getchar, 
2-29 

etext location, 1-2, 2-16 
etoa function, 2-17 
exception condition, 68000 . 
2-53 

executable file, B-2 
exit function, 2-18 
_exit function, 2-18 
exp function, 2-19 
extended character sets, 3-6 
EXTERN, 3-4 
external, 
names, 1-4 
reference, B-2 
variable, 2-40 

F 

-F option, B-2 
fabs function, 2-20 
fcetc function, 2-29 
fclose function, 2-21 
fdopen function, 2-25 
feof function, 2-22 
f error function, 2-22, 2-36 
f flush function, 2-21 
fgetc function, 2-29 
fgets function, 2-33 
field width, 2-43 
file access, 

terminating, 2-11 
legal, 2-5 

file data, reading, 2-49 

file descriptor, 2-63 

file I/O, 1-5 

file pointer, 2-49 

file sire, reducing, B-3 

file statements, 3-7 

file streams, manipulating, 

file.0, B-2 
file.C, B-l 


file. I, B-l 
file. IC, B-l 
file.S, B-2 
file. ST, B-l 

filename, temporary, 2-38 
fileno function, 2-22 
^ii- e s, changing protection and 
ID, 2-10 
floating-point, 
conversion, 2-43 
routines, 2-2 

flushing stream files, 2-21 
floor function, 2-23 
fmod function, 2-24 
fopen function, 2-25 
fopena function, 2-25 
fopenb function, 2-25 
for, 3-8 
form feed, 2-14 
formatting data, 2-42 
fprintf function, 2-42 
fputc function , 2-44 
fputs function, 2-46 
frame pointer, 1-2 
fread function, 2-27 
free function, 1-2, 2-8 
freopa function, 2-25 
freopb function, 2-25 
freopen function, 2-25 
fscanf function, 2-50 
fseek function , 2-28, 2-64 
ftell function, 22-28 
ftoa function, 2-17 
fwrite functions, 2-27 

6 

getc function, 2-29, 2-64 
getchar function, 2-29 
getl function, 2-29 
getpass function, 2-31 
getpid function, 2-32 
gets function, 2-33 
getw function, 2-29 
GLOBAL, 3-4 

global data areas, 3-1 
global variable, 3-3 

H 

header file, 3-2 
heap management, 1-2 
heap space, allocating, 2-8 
heap extending, 2-7 
hex constant, 3-2 
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hexadecimal ASCII, 2-43 
integer conversion, 2-51 
high bytes, reversing with low 
bytes, 2-61 

I 

-I flag, B-l 
♦include, B-l 
♦include "file.h", 3-2 
I/O, 

redirection, 1-7 
stream, 2-25 
device, 1-5 
file, 1-5 
single-byte, 1-5 
if, 3-8 

illegal instruction t^ap, 2-53 
include files, nesting, 3-2 
indention technique, 3-8 
index function, 2-34 
initialization file, B-2 
initialized data, 1-1, 3-6 
input, 1-6 
format, 2-50 
stream, 2-64 
instruction trap, 2-3 
int, 

random number seed, 2-48 
variable length, 3-2 
intermediate code file, B-l 
intermodule communication, 
using procedure calls, 3-1 
isalnum(c), 2-14 
isalpha(c), 2-14 
isascii(c), 2-14 
isatty function, 2-35 
iscntrl(c), 2-14 
isdigit (c) , 2-14 
islower ( c) , 2-14 
isprint(c), 2-14 
ispunct(c) , 2-14 
isspace(c), 2-14 
isupper(c), 2-14 

J 

JSR instruction, 1-2 

I. 

L character, 2-43 
-L flag, B-2 
-L option, B-2 


language library, compatibility 
with UNIX V7 , 2-1 
leading sign, 2-6 
leading spaces, 2-6 
line A trap, 2-53 
line F trap, 2-53 
line-feed, 1-6, 2-14, 2-50 
linkage editor, 1-2, B-2 
linker, B-l, B-2, B-3, B-4 
linker, invoking, 1-1 
listing device, 2-28 
literal matches, 2-51 
L068, B-l, B-2 
load modules, B-3 
load time, reducing, B-3 
LOCAL, 3-4, 3-7 
local variable names, 3-3 
log function, 2-36 
logical, 3-5 
LONG, 3-4 

long, 32-bit, 2-29. 2-43 
long masking constant, 3-5 
longjmp function, 2-52 
low bytes, reversing with high 
bytes, 2-61 

lower-case, 2-2, 3-2, 3-3 
lseek function, 2-37 
LST: , 1-5 

M 

macro, 2-4. 2-15, 2-29, 2-44 
macro definitions, 3-2 
maintenance costs, 3-1 
maintenance documentation, 3-8 
malloc function, 1-2, 2-8 
mandatory coding conventions, 

3-2 

margin, 3-8 
masking, 3-5 
memory allocation, 2-15 
memory layouts of C programs, 

1-1 

minus sign, 2-43 
mktemp function, 2-38 
MLOCAL, 3-4 
modular programs, 3-1 
module, 

layout, 3-7 
size, 3-1 

module-specific #define 
statements, 3-7 
movem.l instruction, 1-4 
multibyte binary variables, 3-2 
multicharacter constants, 3-5 
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n 

nesting level, 3-8 
newline, 2-50 

character, 2-33, 2-46 
incompatibility, 2-46 
NO-OPS, 2-10 
nonlocal goto, 2-52 
null statement, 3-8 
null-terminated string, 
2-43, 2-46 
concatenating, 2-57 

O 

o character, 2-51 
o operator, 2-4,3 
-0 f ile.68K, B-2 
object code, reducing size, 
2-29 
octal, 

ASCII, 2-43, 2-51 
constant, 3-2 
open function, 2-11, 2-39. 
2-25, 2-49 

open stream, 2-22, 2-50 
opena function, 2-39 
openb function, 2-39 
opening files, 2-39 
operations, 3-5 
OR, 3-5 
output, 1-6 
file, B-l 

left-adjusted, 2-43 
right-adjusted, 2-43 
overflow, detection and 
reporting, 2-6 

P 

padding, blank or zero, 2-43 
parentheses, 3-2, 3-4 
parser, B-l 
password, 2-31 
PDP-11, 2-61 
percent sign, %, 2-42 
peripheral devices, 1-5 
perror function, 2-40, A-l 
pointer arithmetic, 3-5 
portability, 3-1 to 3-7 
pow function, 2-41 
precision field, 2-43 
precision string, 2-43 
preprocessor, B-l 
primary memory, 2-27 


printf function, 2-42, 3-2, 3-5 
printing characters, 2-14 
privilege violation, 2-53 
procedure definitions, 3-7 
procedure header, 3-7 
process ID, false, 2-32 
punctuation characters, 2-14 
pushed-back characters, 2-64 
putc function, 2-44 
putchar function, 2-44 
putl function, 2-44 
puts function, 2-46 
putw function, 2-44 

Q 

qsort function, 2-47 
quick sort routine, 2-47 

R 

-R option, B-2 
rand function, 2-48 
random number generator, 2-48 
random numbers, retrieving, 

2-48 

read errors, 2-30 
read function, 2-49, 2-29 
read pointer, 2-28 
readability, improving, 3-8 
realloc function, 2-8 
references, global, 3-7 
REG, 3-4 

registers, scratch, 1-4 
regular files, 1-6 
reloc utility, B-3 
relocatable files, B-2 
rewind function, 2-28 
rindex function, 2-34 
ROM, 3-6 

run-time start-up routine, B-2 
S 

s character, 2-51 

8 operator, 2-43 

-S option, B-2 

-S switch, B-4 

sample C module, C-l 

sbrk function, 1-2, 2-7, 2-16 

scanf function, 2-50 

screen editing, 3-8 

seed, 2-48 

set jmp function, 2-52 
sign-extending characters, 3-2 
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signal function, 2-53 
signed characters, 2-58 
sin function, 2-12 
single-byte 1/0, 1-5 
single-density disk system, 
sinh function, 2-55 
source file, B-l 
space, 2-14 

allocation for array, 2—8 
sprintf function, 2-42 
sqrt function, 2-56 
srand function, 2-48 
sscanf function, 2-50 
stack frame, 1-4 
stack use, 1-2 
stack -popping code, 1-4 
standard error file, J^-6 
standard type definitions, 3 
start-up file, B-2 
static data, 2-31 
static variables, 3-6 
stderr, 1-6 
stdin, 1-6 

<stdio.h> file, 1-6, 2-4, 
2-29, 2-44 
stdout, 1-6 
storage class, 3-7 
definitions, 3-3 
strcat function, 2-57 
strcmp function, 2-58 
strcpy function, 2-59 
stream, 

address, 2-21 
buffer, 2-37 
file, 2-28, 2-33 
output file, 2-18 
string, 

comparison, 2-58 
length, 2-58 
null-terminated, 2-31 
variables, 3-5 
strlen function, 2-60 
strncat function, 2-57 
strncpy function, 2-59 
strncmp function, 2-58 
stylistic rules in C 
programs, 3-1 
submit files, B-3 
subroutine calls, 1-4 
subtraction, 3-5 
suppressed assignments, 2-41 
swab function, 2-61 
swapping binary data, 2-61 
symbolic constants, 3-2 
symbolic names, A-l 


system, 
calls, 2-1 
error, 2-40 
include files, B-l 
traps, 2-1 
system-wide file, 3-2 

T 

-T switch, B-4 
tab, 2-14, 2-50, 3-8 
tan function, 2-62 
tanh function, 2-55 
tell function, 2-37 
temporary file, B-l 
terminal device, 2-63 
terminating current program, 

text, 3-6 
tilde, 2-14 
trace trap, 2-51 
trailing null, 2-46, 2-51 
transferring data, 2-66 
TRAPV instruction, 2-51 
ttyname function, 2-63 
type, 3-2 

type definitions, 3-3 
typedef 3-3 

U 

u operator, 2-43 
-U option, B-2 
UBYTE, 3-4 

underline character, 1-4 
ungetc function, 2-64 
uninitialized data, 1 - 1 , 3 - 6 
UNIX, 

compatibility, 2-9, 2-40. 
2-46, 2-53 

versions 1 through 6, 2-37 
version 7, A-2 
with fopen, 2-26 
with getpid, 2-32 
with getchar, 2-30 
UNIX programs, with binary 
files, 2-39 
unlink function, 2-65 
unsigned characters, 2-58 
unsigned int, 3-2 
upper bound of program, 
setting, 2-7 

upper-case, 2-2, 3-2, 3-3 
user control block, 1-5 
UWORD, 3-4 


Index-6 



V 


variable, 3-7 
variable names, 
global, 3-3 
local, 3-3 
lower-case, 3-3 
variable type, 3-7 
VAX, 2-61 

vectors, sorting, 2-47 
VOID, 3-4 

W 

while, 3-8 

white space characters, 2-14 

WORD, 3-4 

word, ' 

16-bit, 2-44 
32-bit word, 2-3 
word boundary, 2-8 
write function, 2-44, 2-66 
write pointer, 2-28 

X 

X characters, 2-38, 2-44, 2-51 
X operator, 2-43 

Z 

zero divide, 2-53 
zero padding, 2-43 
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